JWT の外部ログイン情報の作成および編集
JSON Web トークン (JWT) を使用して外部システムへの認証を管理するには、JWT 認証プロトコルを使用する外部ログイン情報を作成します。JWT 認証プロトコルでは、サーバー間インテグレーションがサポートされます。
必要なエディション
| 使用可能なインターフェース: Salesforce Classic (一部の組織で使用可能) および Lightning Experience の両方 |
| 使用可能なエディション: すべてのエディション |
| 必要なユーザー権限 | |
|---|---|
| 外部ログイン情報を表示する | 「設定・定義の参照」 |
| 外部ログイン情報を作成、編集、または削除する | 「指定ログイン情報の管理」または「アプリケーションのカスタマイズ」 |
- [設定] から、[クイック検索] ボックスを使用して [指定ログイン情報] を見つけて選択します。
- [外部ログイン情報] をクリックします。
- 新規外部ログイン情報を作成するには、[新規] をクリックします。既存の外部ログイン情報を編集するには、外部ログイン情報のリスト内のリンクをクリックして [編集] をクリックします。
-
項目に入力します。
項目 説明 表示ラベル リストビューなどの Salesforce ユーザーインターフェースに表示される、外部ログイン情報のわかりやすい名前。 名前 コールアウト定義および API からこの外部ログイン情報を参照する場合に使用される一意の ID。
名前には、アンダースコアと英数字のみを使用できます。一意であること、最初は文字であること、空白は使用しない、最後にアンダースコアを使用しない、2 つ続けてアンダースコアを使用しないという制約があります。
認証プロトコル [JWT] を選択します。
JWT クレームの完全なリストについては、「指定ログイン情報の JWT クレームの設定」を参照してください。
発行者 (iss) JWT の発行者を指定します。これは数式です。たとえば、メール ID を返すには、数式 {!$User.Email}を使用します。件名 (sub) トークンの対象者 (ユーザー) を指定します。これは数式です。 利用者 (aud) トークンを利用する受信者を指定します。 JWT の有効期限 (秒) トークンが期限切れになる時間を指定します。1970-01-01T00:00:00Z UTC から指定された UTC 日時までの秒数 (閏秒は無視) を表す NumericDate 値として表されます。 署名証明書 JWT の外部システムの認証を検証するために使用される証明書を指定します。 署名アルゴリズム トークンの署名に使用されるアルゴリズムを指定します。有効な値は、RS256 (デフォルト) と RS512 です。 - 外部ログイン情報を保存します。
JWT のプリンシパルの作成
JWT 認証を使用する外部ログイン情報を作成したら、そのプリンシパルを作成します。アクセス権を付与するには、プリンシパルを権限セットまたはプロファイルに対応付けます。コールアウトを実行するユーザーには、プリンシパルに対する権限が必要です。
- [指定ログイン情報] ページで、[外部ログイン情報] をクリックします。
- 作成した外部ログイン情報を選択します。
- [プリンシパル] までスクロールします。
-
外部ログイン情報のプリンシパルを作成するには、[新規] をクリックするか、既存のプリンシパルの [アクション] メニューから [編集] を選択します。
既存のプリンシパルを編集する場合、ここにリストされているすべての項目が変更可能とは限りません。
-
プリンシパルの情報を入力します。
項目 説明 パラメーター名 「Admin」 (システム管理者) や「Marketing Group」 (マーケティンググループ) などのプリンシパルの名前を入力します。 連番 連番を割り当てます。連番では、ユーザーが参加しているプリンシパルが複数あるときに適用するプリンシパルの順序を指定します。たとえば、ユーザーは、ログイン情報プロバイダーで適用される複数の権限セットに割り当てることができます。優先度は、番号の小さい方が高くなります。 ID 種別 [指定ユーザー] または [ユーザーごとのプリンシパル] を選択します。
各外部ログイン情報は、組織の指定ユーザーを使用するように設定することも、ユーザーごとの認証を使用するように設定することもできます。指定ユーザーでは同じログイン情報または認証設定を組織全体に適用しますが、ユーザーごとの認証では個々のユーザーレベルでアクセスコントロールを提供します。
-
プリンシパルを保存します。
既存のプリンシパルのプリンシパル名と ID 種別は変更できません。これらのパラメーターを変更するには、プリンシパルを削除して再作成します。
外部ログイン情報とプリンシパルを作成したら、次は接続名ログイン情報を作成します。「指定ログイン情報の作成および編集」を参照してください。指定ログイン情報を設定するために必要なすべての手順の概要は、「Create Named Credentials and External Credentials (指定ログイン情報と外部ログイン情報の作成)」を参照してください。
