Okta Integration Wizard:統合の詳細

Oktaでのプライベート統合の表示方法を定義するフィールドと、実行時にアプリインスタンスごとの構成値をマッピングするテナント変数。利用可能なフィールドは、選択した機能によって異なります。

カスタムアプリのプロパティ

表 1. カスタムアプリのプロパティ
フィールド 説明
表示名

統合の名前を64文字以内で入力します。これは、OINで統合に使用されるメインタイトルです。

このフィールドは必須です。

説明(Description)

アプリの概要と、この統合のメリットを入力します。アプリの説明は1024文字以下にする必要があります。説明はOINカタログに表示されます。「アプリの説明例」を参照してください。

このフィールドは必須です。

ロゴ

カタログで統合に掲載する、ロゴのPNG、JPG、またはGIFファイルをアップロードします。ロゴファイルは、1MB未満である必要があります。「ロゴガイドライン」を参照してください。

このフィールドは必須です。

テナント設定

表 2. テナント設定
フィールド 説明
ラベル(Label) 管理者がアプリ統合をインストールする際に表示されるテナント設定ラベル。例:SubdomainまたはTenant name
名前(Name)

テナント設定の変数名には、英数字の小文字とアンダースコアを使用します。最初の文字は英字にする必要があり、フィールドの最大長は1024文字です。例:subdomain_div1

サポートされている変数タイプは文字列のみです。

この変数名は、テナントに依存する動的URLやその他のアプリプロパティを構築するために使用されます。これは管理者には表示されず、テナントの詳細を外部アプリに渡すためにのみ使用されます。

認証設定

表 3. 認証設定
フィールド 説明
認証モード

API Integration ActionsまたはSCIMサーバーへのアウトバウンドコールを行うための認証モードを選択します。

  • ヘッダー(Header)Authorization: {API token}の形式で、顧客が提供したトークンを含む認可ヘッダーを使用します。

  • ベアラー(Bearer): Authorization: Bearer {API token}の形式で、顧客が提供したベアラートークンを含む認可ヘッダーを使用します。
  • OAuth 2.0:OAuth 2.0認証コード付与フローを使用します。これは、API Integration Actionsを選択した場合のデフォルトの選択であり、変更できません。

注(Note):SCIMではBasic認証はサポートされていません。「SCIM統合の制限事項」を参照してください。

このフィールドは必須です。

OAuth 2.0設定
エンドポイントの認可

HTTPS認可エンドポイントを指定します。例:https://myexample.com/oauth2/auth

動的エンドポイントURLを指定できます。「Okta Expression Languageを使用した動的プロパティ」を参照してください。

このフィールドは必須です。

トークンエンドポイント

HTTPSトークンエンドポイントを指定します。例:https://myexample.com/oauth2/token

動的エンドポイントURLを指定できます。「Okta Expression Languageを使用した動的プロパティ」を参照してください。

このフィールドは必須です。

クライアントID クライアントIDを指定します。

API integration actions用にこれを設定する場合は、統合ビルダーにマッピングする値を指定します。任意の文字列フィールドを指定できます。このフィールドは、統合ビルダーのプロジェクトの認証マッピング(Authentication mapping)セクションにあるクライアントID(Client ID)フィールド(auth.client_id)に自動的にマッピングされます。

このフィールドは必須です。

クライアントシークレット クライアントシークレットを指定します。

API integration actions用にこれを設定する場合は、統合ビルダーにマッピングする値を指定します。任意の文字列フィールドを指定できます。このフィールドは、統合ビルダーのプロジェクトの認証マッピング(Authentication mapping)セクションにあるクライアントシークレット(Client Secret)フィールド(auth.client_secret)に自動的にマッピングされます。

このフィールドは必須です。

スコープ 任意。スコープを指定します。

API Integration Actions用にこれを構成する場合は、アクセスするリソースのスコープを指定します。