このページはAIで翻訳されています。コミュニティによるレビューはまだ行われていません。 英語で読む

ブログ · 2023年10月3日 · Steve Simpson · ID

簡単な OAuth 統合のための Salesforce 接続アプリケーションの設定:手順ガイド

スムーズな OAuth 統合のための Salesforce 接続アプリケーションの設定ガイドへようこそ。この手順ごとのチュートリアルでは、Salesforce で接続アプリケーションを設定し、Postman から API でアクセスする基本を学びます。接続アプリケーションの設定から始めて、OAuth を深く掘り下げましょう。

手順1:新しい接続アプリケーションを作る

アプリケーションマネージャーに移動する: まず Salesforce のアプリケーションマネージャーを開きます。

API アクセスを有効にする: 外部アプリケーションから API でアクセスできるよう、新しい接続アプリケーションを作り、「App One」と名付けます。

アプリケーションを設定する: アプリケーションのメールアドレスを入力し、OAuth の設定を有効にします。一部の OAuth フローにはコールバック URL が必要ですが(今後のガイドで扱います)、今は「www.salesforce.com」のようなダミーの値を入力しておきます。 (opens in a new tab)

スクリーンショット:アプリケーションマネージャーで新しい接続アプリケーションを作り、OAuth 設定を有効にしている スクリーンショット:接続アプリケーションの OAuth 範囲を選び、コールバック URL を設定している

手順2:OAuth 範囲を設定する

範囲は、API を通じてアクセスできる機能を定義します。このチュートリアルでは:

ユーザーデータの管理: API を通じてユーザーデータを管理できる範囲を割り当てます。

保存して待つ: 設定を保存し、処理が完了するまで約10分待ちます。

手順3:コンシューマーの詳細を取得する

処理が完了したら、公開されていない二つの重要な情報が必要です。コンシューマー鍵とコンシューマーの秘密です。それぞれのボタンを押して認証し、「App One」のこれらの詳細を取得します。

手順4:Postman で認証する

Postman のスクリーンショット:Salesforce の OAuth トークンエンドポイントへの POST が、アクセストークンを返している

POST 呼び出しを始める: Postman で、OAuth サーバーの「login.salesforce.com/services/oauth2/token」への POST 呼び出しを作ります。

パラメーターを設定する: 本文にパラメーターを入れます。grant type(password)、client ID(コンシューマー鍵)、Client Secret(コンシューマーの秘密)です。

ユーザーの認証情報を入れる: パラメーターにユーザー名とパスワードを加え、OAuth エンドポイントに POST して認証します。

手順5:アクセストークンとクエリ

認証に成功したら:

アクセストークンを得る: API 呼び出しに必要なアクセストークンを受け取ります。

トークンを入れる: Postman のクエリリクエストで、ヘッダーの Authorization の行に「Bearer」という語に続けてアクセストークンを入れます。

Postman のスクリーンショット:Authorization ヘッダーにアクセストークンを使った REST クエリが、レコードを JSON で返している

クエリを実行する: トークンを入れたらリクエストを送ってクエリを実行し、データを取得します。

手順6:エンドポイントのバージョンと追加の手順

これで、接続アプリケーションのエンドポイントのバージョン(例:バージョン58)にアクセスしてデータを取得できます。この基本の設定には追加のフロー要素やコールバックのすべては含まれませんが、Postman と Salesforce での OAuth 統合の土台となる一歩になります。

まとめと次のステップ

これで、Salesforce の接続アプリケーションを設定し、Postman から API にアクセスするために OAuth で認証することができました。このガイドは基本を扱いましたが、今後のチュートリアルでは、アプリケーションの機能を高める追加の OAuth フローや機能を紹介します。

お楽しみに

自信を持って Salesforce API の旅に出かけましょう! さらなる知見やヒントは、この www.SteveTechArc.com と YouTube チャンネル @SteveTechArc (opens in a new tab) で。チャンネル登録して、Salesforce と、それをほかのシステムとどう統合できるかの理解を深めてください。

アーキテクト仲間やアーキテクトを目指す人たちと統合の知識を共有して、世界を変える手助けを!

文字起こしには AI を活用

STA 3.11