Skip to main content
OIDC アプリケーションを使用すると、Iru が ID プロバイダーとして機能し、ユーザーは OpenID Connect をサポートするサービスにサインインできます。Iru はサービスにクライアント ID と クライアントシークレットを発行し、サインオン後に ID トークンを送信し、ユーザーのプロファイル 属性をそのトークンのクレームにマッピングします。 これらのセクションを使用して、カスタム OIDC アプリ、または テンプレートから切り離したアプリを設定します。 設定はドラフトで編集し、現在のバージョンとして設定します。バージョンモデルについては アプリケーションの概要を参照してください。

ステップ 1:クライアント資格情報を保存する

OIDC アプリを作成すると、Iru はクライアント ID とクライアントシークレットを生成します。 シークレットは一度だけ表示されるため、ダイアログを閉じる前に両方を安全な場所にコピーしてください。
クライアントシークレットは作成後に再表示されません。紛失した場合は、シークレットをローテーションして 新しいシークレットを生成してください。
アプリの Protocol details には、サービスが Iru と通信するために必要なエンドポイントも表示されます。

ステップ 2:リダイレクト URI を設定する

アプリのドラフトの OIDC 設定で、Iru がリダイレクトを許可される URI を追加します。
1

許可されたサインインリダイレクト URI

サインオンが成功した後に Iru がユーザーを戻す場所。サービスが使用するすべての URL を追加します。
2

許可されたサインアウトリダイレクト URI

サインアウト後に Iru がユーザーを戻す場所。
リダイレクト URI は完全に一致する必要があります。リダイレクト URI でワイルドカードを許可する オプションがありますが、完全一致の方が安全なため、サービスで特に必要な場合を除きオフにしておいてください。

ステップ 3:スコープを選択する

スコープは、サービスが要求できるクレームのカテゴリを制御します。Iru は標準の OpenID Connect スコープを提供しています。
openid は常に存在し、削除できません。サービスが本当に必要とする追加のスコープのみを有効にしてください。

ステップ 4:サブジェクトとクレームをマッピングする

アプリケーションのマッピングを開きます。マッピングには 件名 と追加のクレームがあります。

サブジェクト

サブジェクトは、サインインしたユーザーの主要な識別子であり、sub クレームとして送信されます。 OIDC アプリの場合、デフォルトのサブジェクトはユーザーの user.id からマッピングされます。 取得元の値を変更し、スコープに関連付けることができます。

クレーム

サービスが ID トークンに想定する追加のクレームを追加します。それぞれについて次を設定します。
  • Name: クレーム名。
  • 値: 取得元のプロファイル属性または式。
  • スコープ: クレームが属するスコープ。
  • 有効かどうか。
ライブプレビューに生成されるトークンが表示されるため、公開前にクレームを確認できます。
一部のクレーム名は OpenID Connect 標準で予約されており、カスタムクレームとして使用できません: iss、aud、exp、nbf、iat、jti。

ステップ 5:クライアントシークレットをローテーションする

クライアントシークレットは、アプリを再作成することなく、アプリの Protocol details → Client secrets からローテーションできます。
Rotate を実行すると新しいクライアントシークレットが発行され、以前のシークレットは 24 時間引き続き機能するため、古いシークレットが停止する前にサービスを更新できます。 その期間中、以前のシークレットには Expires Soon バッジが表示されます。新しく発行された シークレットは長期間有効です。
Invalidate を実行すると、猶予期間なしに現在のシークレットが直ちに終了します。 シークレットが漏洩した可能性がある場合に使用し、すぐにサービスを更新してください。
Iru は ID トークンの署名に使用する署名キーを管理し、ディスカバリーおよびキーのエンドポイントで 公開しているため、サービスはトークンを自動的に検証します。手動でローテーションする必要はありません。

ステップ 6:公開、割り当て、有効化

1

ドラフトを現在のバージョンとして設定する

ドラフトを公開して、ライブの設定にします。
2

アクセスを割り当てる

アプリを使用するグループを割り当てます。 アクセスの割り当てを参照してください。
3

有効化する

割り当てられたユーザーがサインインできるよう、アプリをアクティブにします。
4

サインオンをテストする

アプリダッシュボードからテストユーザーとしてサインインし、エクスペリエンスを確認します。

認証フロー

OIDC アプリは認可コードフローでユーザーをサインインさせます。
1

Iru にリダイレクトする

アプリはユーザーをサインインのために Iru に送ります。
2

認証してポリシーを評価する

Iru はユーザーを認証し、アプリの認証ポリシーを評価します。
3

認可コードを返す

Iru は短期間有効な認可コードとともに、アプリのリダイレクト URI にリダイレクトします。
4

コードをトークンと交換する

アプリは Iru のトークンエンドポイントでコードを ID トークン(ユーザーが誰であるか)と アクセストークンに交換します。
5

クレームを読み取る(およびサインイン状態を維持する)

アプリはアクセストークンを使用してユーザー情報エンドポイントを呼び出してプロファイルクレームを 読み取ることができ、(offline_access を有効にした場合)リフレッシュトークンを使用して サインイン状態を維持できます。
ほとんどのライブラリは、Protocol details の Well-Known URL からこのフロー全体を設定します。

次のステップ

アクセスの割り当て

ユーザーとグループにアプリへのアクセスを付与します。

プロビジョニング

アクセスの変更に応じて、アプリのアカウントを自動的に作成および削除します。

認証ポリシー

サインインできるユーザーと、証明する必要がある内容を決定します。

アプリケーションの概要

プロトコルと、ドラフトから現在へのバージョンモデルを確認します。