🎍

Salesforceの第一世代管理パッケージにおけるSOAP API login() の廃止に向けた対応(詳細)

に公開
2026/03/18

はじめに

本記事では、1GP管理パッケージを開発している方向けに、SalesforceのSOAP API login()の廃止に向けた対応方法を紹介します。

SOAP API login()の廃止と外部クライアントアプリケーションへの移行

SalesforceはSOAP API login()を廃止し、サポートを終了することを発表しました。

https://help.salesforce.com/s/articleView?id=005132110&language=en_US&type=1

すでに2026年1月時点でも、APIバージョン65.0以降ではSOAP API login()が使用できなくなっていたり、新しい組織では[設定] - [ユーザーインターフェース]の「SOAP API login() を有効化」が必要になっているなど、段階的に廃止に向けた変更が始まっています。
最終的にSummer '27がリリースされる2027年の6月頃には、全面的(APIバージョン31.0〜64.0)に利用不可になるようです。
そのためSOAP API login()を使っている組織においては対応が必須となっています。

かわりの移行手段としては「外部クライアントアプリケーションおよびOAuth」の利用が推奨されています。これまでSalesforceへ外部からアクセスするには「接続アプリケーション」を利用することが定石でした。
ですが、接続アプリケーションはSpring '26から新規作成がデフォルトで無効化されており、今後は接続アプリケーションではなく「外部クライアントアプリケーション」を使っていく必要があるようです。

1GP管理パッケージでは外部クライアントアプリケーションを含められない

今回はパッケージ開発者(AppExchange)を対象にしています。
Salesforceパッケージには大きく2つの世代(1GPと2GP)がありますが、私たちが開発・提供しているものも含め1GPはまだまだ現役です。

外部クライアントアプリケーションは2GP管理パッケージを念頭に置いて設計されており、1GP管理パッケージでは外部クライアントアプリケーションを含めることができないという問題があります。

https://help.salesforce.com/s/articleView?id=xcloud.configure_packageable_external_client_apps.htm&language=en_US&type=5

したがって素直に外部クライアントアプリケーションに移行しようにもできないわけです…。

選択肢

解決策としては、大きく3つのアプローチがありそうです。

1GP管理パッケージを2GP管理パッケージに移行する

まずは1GP管理パッケージを2GP管理パッケージに移行し、外部クライアントアプリケーションをパッケージに含めるというやり方です。

1GPから2GPへのマイグレーションが2025年6月にGAになっており、うまく移行できれば理想的ではありそうです。

https://developer.salesforce.com/blogs/2023/05/move-to-managed-2gp-with-package-migrations

ですが1GPから2GPへの移行は注意点も多く、私たちのパッケージは大きいパッケージということもあり、移行ツールの成熟度(情報やノウハウが少ない)や問題が起きた時の切り戻しのリスクなどを鑑みると、まだ時期尚早と判断しました。

https://note.com/atskimura/n/n179152b63c5b

1GP管理パッケージと別の2GP管理パッケージを作成して管理する

1GP管理パッケージには手を加えずに、新たに2GP管理パッケージを作成し、新パッケージ側で外部クライアントアプリケーションを含めるというやり方です。
Salesforceのパッケージ開発では、コアパッケージと別に「拡張パッケージ」として様々な拡張機能を個々のパッケージとして構成できます。また、1GP管理パッケージと2GPパッケージの共存も可能です。

注意点としては、別のパッケージを作ることになるため、各組織に追加でパッケージインストールが必要になることと、管理パッケージであるため転送アップグレードを有効化するには開発組織として有料組織が必要になる点です。
一度インストールした後は転送アップグレードによって一括アップグレードができるようになるのですが、初回のインストールだけは個別の対応が必要になります。

1GP管理パッケージのまま、外部クライアントアプリケーションではなく、接続アプリケーションで管理する

外部クライアントアプリケーションではなく、従来の接続アプリケーションを1GP管理パッケージに含める方法です。既存組織への展開のハードルは一番低い方法と言えそうです。
ただ、接続アプリケーションについては、去年の9月に未インストールの接続アプリケーションに対する使用制限が急に適用されたり[1]、直近のリリースで新規作成がデフォルト無効化されるようになったという経緯もあり、既存組織向けの方法と言えます。

外部クライアントアプリケーションを含めた2GP管理パッケージの作成

結論としては、デメリットが一番小さい(許容できる)という理由から、2番目の「1GP管理パッケージと別の2GP管理パッケージを作成して管理する」方法を採用しました。

ロック解除済みパッケージではなく管理パッケージである理由

今回はロック解除済みパッケージ、組織連動ロック解除済みパッケージではなく、管理パッケージとして開発しています。

管理パッケージとして開発することで、OAuthの設定をパッケージ開発組織(ソース組織)で完結し、一元的に構成管理ができるためです。
なるべくインストール先組織での手動設定を最小にしたい場合には、管理パッケージにするのがベストだと思います。

JWT ベアラーフローでJWTの電子署名を行うための秘密鍵・証明書を作成

外部クライアントアプリケーションの認証方式としてはOAuthを用います。
OAuthには何種類かのフローがありますが、今回はJWT ベアラーフローを利用します。

JWT ベアラーフローを使う理由

外部クライアントアプリケーションの設定として、OAuthフローでは、以下のようなフローをそれぞれ選択できるようになっています。

  • クライアントログイン情報フロー
  • 認証コードおよびログイン情報フロー
  • デバイスフロー
  • JWT ベアラーフロー
  • トークン交換フロー

SOAP API login()からの移行の場合はシステム連携となるため、ブラウザとユーザの介在が必要なフローでは適用が難しいです。そのため「認証コードおよびログイン情報フロー」はマッチしません。

一番シンプルなのは「クライアントログイン情報フロー」ですが、このフローは固定のユーザーを紐づける必要があるため、複数のユーザーでログインしたい場合には不向きです。

「デバイスフロー」に゙関しては、すでに接続アプリケーションではサポートが廃止(すべてブロック)になっていることから、外部クライアントアプリケーションでも選択しないほうが無難でしょう。

また「トークン交換フロー」はサードパーティIdPからのトークンをSalesforceトークンと交換するものであり、サードパーティIdP側で有効なトークン発行の仕組みが必要になるため、使えるシーンが限られています。

上記のことから、システム連携で利用でき、複数ユーザーにおけるSOAP API login()からの移行に対応できる選択肢として「JWT ベアラーフロー」を採用しました。

JWTの電子署名を行うための秘密鍵および証明書を作成します。

openssl req -x509 -sha256 -nodes -days 3650 -newkey rsa:2048 -keyout server.key -out server.crt

Country Name (2 letter code) [AU]:JP
State or Province Name (full name) [Some-State]:Tokyo
Locality Name (eg, city) []:Minato-ku
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Cariot, Inc.
Organizational Unit Name (eg, section) []:Development
Common Name (e.g. server FQDN or YOUR name) []:cariot-sf-jwt-auth
Email Address []:

ここで作成した証明書 server.crt は外部クライアントアプリケーション作成時に利用し、秘密鍵 server.key は認証時に利用するため、厳重に管理します。

パッケージ開発組織の作成

まずは、Dev Hub組織を作成します。

作成後は、[設定] - [Dev Hub]から「Dev Hub を有効化」と「ロック解除済みパッケージと第二世代管理パッケージを有効化」しておきましょう。

パッケージの作成準備

パッケージ作成のためのプロジェクトを準備します。操作はSalesforce CLIで行います。

  • Dev Hub組織への接続
sf org login web -a dev-hub
  • プロジェクトの作成
sf project generate -n test-pkg

名前空間のリンク

管理パッケージを作成するために、名前空間を指定する必要があります。

前提として名前空間を所有する「名前空間組織」と、パッケージを作成する「Dev Hub 組織」を連携させておかなければなりません。

名前空間のリンクは以下の手順で行います。

  1. アプリケーションランチャーから「名前空間レジストリ」を開きます。
  2. 「名前空間をリンク」ボタンをクリックします。
  3. ポップアップが出るので、名前空間を取得済みの組織のログインID/パスワードでログインし、アクセスを許可します。

次にプロジェクトのルートにある sfdx-project.json ファイルを編集し、 namespace にリンクした名前空間を指定します。

sfdx-project.json
{
  "packageDirectories": [
    {
      "path": "force-app",
      "default": true,
      "package": "TestPkg",
      "versionName": "ver 0.1",
      "versionNumber": "0.1.0.NEXT"
    }
  ],
  "namespace": "jxxxx", // ここに名前空間を記述
  "sourceApiVersion": "59.0"
}

外部クライアントアプリケーションの作成

通常、Salesforce CLIを使った開発では、この後にスクラッチ組織を作成してApexなどを開発・テストしていきます。
ですが、外部クライアントアプリケーションは、スクラッチ組織のような短命(最大30日間)の組織では作成が許可されていません。恒久的な組織で作成する必要があります。
エラーメッセージが直感的でなくわかりづらいのですが、スクラッチ組織で作成しようとすると

[組織の範囲設定された外部クライアントアプリケーションの形式は DeveloperOrganizationId:ExternalClientAppDeveloperName である必要があります。]

といったエラーが表示されます。

そのため外部クライアントアプリケーションは、パッケージ開発組織側で作成します。
[設定] - [外部クライアントアプリケーションマネージャー]にアクセスしましょう。今回は以下の通り設定し、それ以外の項目はデフォルトのままで作成します。

設定項目 設定する内容
外部クライアントアプリケーション名 TestExternalClientApp
API 参照名 TestExternalClientApp
取引先責任者 メール (開発用のメールアドレス)
配信状態 パッケージ化済み
OAuth を有効化 チェック
アプリケーション設定 > コールバック URL https://login.salesforce.com/services/oauth2/success
アプリケーション設定 > OAuth 範囲 いつでも要求を実行(refresh_token, offline_access)
ID URL サービスにアクセス (id, profile, email, address, phone)
API を使用してユーザーデータを管理 (api)
フローの有効化 > JWT ベアラーフローを有効化 チェック
証明書アップロードで作成した server.crt をアップロードする

作成後はコンシューマーの鍵を取得しておきましょう(下図)。これは接続する際に必要になります。
機密情報になりますので、取り扱いには厳重に行ってください。

作成された外部クライアントアプリケーションを手元に取得します。

sf project retrieve start --metadata ExternalClientApplication ExtlClntAppOauthSettings -o dev-hub

パッケージの作成

外部クライアントアプリケーションを含んだパッケージを作成します。

  • 2GP管理パッケージの作成
    パッケージの種類 (-tまたは--package-type)はManagedを指定することに注意しましょう。
cd test-pkg
sf package create -n TestPkg -r force-app -t Managed -v dev-hub
  • バージョンリリース + プロモート
sf package version create -p TestPkg -d force-app -x --wait 10 -v dev-hub --code-coverage
sf package version promote -p "TestPkg@0.1.0-1" -v dev-hub

インストール先組織に対してJWTベアラートークンフローでアクセスしてみる

パッケージインストール

まずはリリースしたパッケージを対象組織にインストールします。

OAuthポリシーを変更し、「管理者が承認したユーザーは事前承認済み」にする

JWTベアラートークンフローを利用するためには、ポリシーの設定を必ず「管理者が承認したユーザーは事前承認済み」にする必要があります。
JWTベアラートークンフローはユーザーの介在なしでアクセストークンを取得するための仕組みです。 このフローでは、承認画面を出すステップが存在しないため事前承認の設定がなされていないと、Salesforce側は「このユーザーはまだこのアプリを承認していない」と判断し、エラーを返します。

ポリシーを「管理者が承認したユーザーは事前承認済み」に変更したら、アクセスを許可するプロファイルまたは権限セットを関連づけます。なお、管理パッケージで管理されている権限セットは関連づけられませんのでご注意ください。

アクセス

最後に、実際にインストール先の組織に接続できるか試してみましょう。
下記はNode.jsでJWTを生成し、JWTベアラートークンフローを用いてアクセストークンを取得し、ユーザー情報を表示する例です(ほぼjsforceのサンプルのままですが)

import { Connection } from "jsforce";
import jwt from "jsonwebtoken";
import * as fs from "fs";

const conn = new Connection();

// 接続アプリのコンシューマ鍵
const ISSUER = "3MVG9ZL0ppGP5....";
// 固定
const AUDIENCE = "https://login.salesforce.com";
// 秘密鍵の読み込み
const cert = fs.readFileSync("./server.key");

const claim = {
  iss: ISSUER,
  aud: AUDIENCE,
  // 接続するSalesforceのユーザアカウント名
  sub: "fixme@example.com",
  exp: Math.floor(Date.now() / 1000) + 3 * 60,
};
const bearerToken = jwt.sign(claim, cert, { algorithm: "RS256" });
const userInfo = await conn.authorize({
  grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
  assertion: bearerToken,
});

console.log(conn.accessToken);
console.log(conn.instanceUrl);

console.log("User ID: " + userInfo.id);
console.log("Org ID: " + userInfo.organizationId);

実行してうまく行けば、ユーザー情報や組織IDが表示されるはずです。

パッケージのアップグレード

パッケージの内容を更新する場合には新しいパッケージをリリースしてインストール先組織にてアップグレードができます。

インストール先の組織にログインした状態で手動アップグレードする場合には問題ありませんが、自動アップデート(転送アップグレード)をする場合、管理パッケージであるためAppExchangeセキュリティレビューを通す必要がありますのでご注意ください。

sf package push-upgrade schedule --package 04tg5000000xxxxxxx --org-list 00Dd500000xxxxx -v dev-hub

Error (1): Specify a package that has passed the AppExchange security review.

おわりに

SalesforceのSOAP API login() の廃止に向けた対応について紹介しました。

1GP管理パッケージでは推奨策である「外部クライアントアプリケーション」が含められないため、2GP管理パッケージに移行するか、別途2GP管理パッケージを作成するなどして回避する必要があります。

普段はロック解除済みパッケージでの開発が多く、2GP管理パッケージの開発は不慣れで色々とハマったので、同じような境遇の方の参考になれば幸いです。

参考

脚注
  1. 接続アプリケーションの使用制限変更の準備 ↩︎

株式会社キャリオット

Discussion