OAuthとRESTの統合を構成する

このトピックでは、OAuth 2.0を介した認証のプロビジョニング向けに、REST APIを使用してSalesforceアプリ統合を設定する方法を説明します。

開始する前の確認事項

  • Salesforceで管理者アカウントを作成します。Salesforce REST統合で使用するOAuthコンシューマーキーとコンシューマーシークレットを作成するには、このアカウントが必要です。
  • Salesforceでカスタムユーザープロファイルを作成します。このプロファイルは、SOAP統合とREST統合の両方に必要です。「Salesforceプロビジョニングを有効にする」を参照してください。

Salesforceで外部クライアントアプリを構成する

Oktaで必要なOAuthコンシューマーキーとコンシューマーシークレットを生成するには、Salesforceで外部クライアントアプリを構成する必要があります。

  1. Salesforceに管理者としてサインインします。
  2. 新しい外部クライアントアプリを作成するか、既存の接続済みアプリを移行します。「外部クライアントアプリを作成する」または「接続済みアプリを外部クライアントアプリに移行する」を参照してください。
  3. 外部クライアントアプリのOAuth設定を構成します。
    • アプリの設定（App settings）セクションで、以下の値を使用します。
      • OAuthを有効化（Enable OAuth）：有効
      • コールバックURL（Callback URL）: https://system-admin.okta.com/admin/app/generic/oauth20redirecthttps://system-admin.okta.com/admin/app/generic/oauth20redirect
      • OAuthスコープ（OAuth Scopes）：Manage user data via APIs (api)およびPerform requests at any time (refresh_token, offline_access)
    • セキュリティ（Security）セクションで、次のオプションを有効にします。
      • Webサーバーフローでシークレットが必要
      • リフレッシュトークンフローでシークレットが必要
      • サポート対象の認可フローでProof Key for Code Exchange（PKCE）拡張機能が必要
      • リフレッシュトークンのローテーションを有効化する
  4. ポリシー（Policies）タブで、以下の値を使用します。
    • 許可済みユーザー（Permitted Users）：すべてのユーザーが自己認可できる
    • リフレッシュトークンポリシー（Refresh Token Policy）：リフレッシュトークンは取り消されるまで有効
  5. 設定（Settings）タブに移動します。OAuth設定（OAuth Settings） > アプリ設定（App Settings）で、コンシューマーキーとシークレット（Consumer Key and Secret）をクリックします。
  6. コンシューマーキー（Consumer Key）とコンシューマーシークレット（Consumer Secret）をコピーします。これらの値は、Oktaでプロビジョニングを構成する際に必要になります。

OAuthとRESTの統合を構成する

  1. Admin Consoleでプロビジョニング（Provisioning） > 統合（Integration）に移動します。
  2. 構成値を入力します。
    • OAuthコンシューマーキー（OAuth Consumer Key）：Salesforceのコンシューマーキーを貼り付けます。
    • OAuthコンシューマーシークレット（OAuth Consumer Secret）：Salesforceのコンシューマーシークレットを貼り付けます。
    • PKCEの有効化（PKCE Enabled）：このチェックボックスを選択します。
  3. Salesforce.comで認証する（Authenticate with Salesforce.com）をクリックします。
  4. 新しいSalesforce.comのウィンドウで、外部クライアントアプリの作成に使用した管理者ユーザー名とパスワードを入力します。過去にSOAP資格情報を入力していれば、再入力する必要はありません。
  5. 許可（Allow）をクリックして、外部クライアントアプリへのOktaアクセスを付与します。
  6. 保存（Save）をクリックします。

これで、OAuth経由でREST APIを使用するようにSalesforce統合が構成されました。