認可

Oktaアカウントへの接続を作成し、このコネクターを認可します。この接続は、このコネクターで次にフローを構築するときに再利用できます。

その他の情報については、「Oktaコネクターに関するガイダンス」を参照してください。

現在のOkta orgから接続を作成する

開始する前に

  • Okta Workflows OAuthアプリに割り当てられている必要があります。

  • Okta Workflows OAuthアプリで必要なスコープが付与されていなければなりません。「スコープの付与または取り消し」と「Oktaコネクターカードのスコープ」を参照してください。

  • スーパー管理者資格情報を持っている必要があります。

    コネクターの初期認可に加え、この接続の再承認にはOktaスーパー管理者、ワークフロー管理者、または接続マネージャーの権限を持つアカウントが必要です。

  • Oktaアカウントの認可には次の情報も必要です。

    • ［Domain（ドメイン）］：Okta orgのドメイン。URLからhttps://プレフィックスまたは-admin部分を除いたもの。たとえば、Okta Admin ConsoleのURLがhttps://yourcompany.okta.comである場合、ドメインはyourcompany.okta.comです。

    • ［Client ID（クライアントID）］と［Client Secret（クライアントシークレット）］：Okta Workflows OAuthアプリのクライアントIDとクライアントシークレット。

      これらの値は、Okta Workflows OAuthアプリケーションを通じて取得できます。

      1. Admin Consoleで、［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。

      2. Okta Workflows OAuthアプリケーションを開きます。

      3. ［サインオン］タブをクリックし、［Client ID（クライアントID）］と［Client secret（クライアントシークレット）］の値をOktaの接続詳細にコピーします。

接続の認可

  1. Okta Workflowsコンソールで［Connections（接続）］に移動します。

  2. ［New Connection（新規接続）］をクリックすると、利用できるすべてのコネクターがリスト表示されます。

  3. Oktaコネクターを選択します。

  4. ［New Connection（新規接続）］ウィンドウで［Connection Nickname（接続ニックネーム）］を入力します。これは、接続リストに表示される表示名です。

  5. ［Domain（ドメイン）］、［Client ID（クライアントID）］、［Client Secret（クライアントシークレット）］の値を入力します。

  6. ［Permissions（権限）］タブをクリックし、［Use default scopes（デフォルトスコープを使用）］または［Customize scopes (advanced)（スコープをカスタマイズ（高度））］を選択します。

    • ［Use default scopes（デフォルトスコープを使用）］：このオプションには、任意のOktaコネクターカードの実行に必要なスコープが含まれます。

    • ［Customize scopes (advanced)（スコープをカスタマイズ（高度））］：この接続のスコープをカスタマイズする場合は、このオプションを選択します。デフォルトのスコープリストにない［Manually add scopes（スコープを手動で追加）］することもできます。存在しないスコープなどの無効なスコープの追加を試みると、接続の作成は失敗します。

    スコープを付与するには：接続を作成する前に、Okta Workflows OAuthアプリでそれらのスコープを付与し、この［権限］タブでスコープを選択します。

    スコープを取り消すには：接続を作成する前に、OAuthアプリからそれらのスコープを取り消すか、付与し、［権限］タブで選択したスコープを消去します。

    OAuthアプリでスコープを付与しない場合でも接続を作成または再認可できますが、その接続にはそれらの付与されていないスコープは含まれません。

    必要なスコープなしでカードを実行しようとすると、不十分なスコープエラーが発生します。

  7. ［Create（作成）］をクリックします。

［Connections（接続）］リストに新しい接続が表示されます。

接続の再承認

既存の接続にスコープの変更を反映させるには、接続を再承認する必要があります。

スコープを変更せずに既存の接続を再承認すると、単に前回の承認のスコープが継承されます。

別のOkta orgのアカウントの認可

現在のorgとは異なるOkta orgの接続を作成するには、次の手順を実行します。

  1. 対象のOkta org内にOpenID Connect Webアプリを作成します。

  2. OpenID Connect Webアプリを構成します。

  3. 対象のOkta orgのアカウントを認可します。

現在のOkta orgの接続を作成するときは、「現在のOkta orgから接続を作成する」を参照してください。

対象のOkta orgでのOIDC Webアプリの作成

  1. Admin Consoleで［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。

  2. ［Create App Integration（アプリ統合を作成）］ をクリックします。

  3. ［Create a new app integration（新しいアプリ統合の作成）］ウィンドウで、［Sign-on Method（サインオン方式）］に［OIDC - OpenID Connect］を選択し、［Application type（アプリケーションタイプ）］を［Web application（Webアプリケーション）］に設定します。

  4. ［Next（次へ）］をクリックします。

  5. ［New Web App Integration（新規Webアプリ統合）］ページで［Application name（アプリケーション名）］を入力します。これは、アプリに表示される表示名です。

  6. アプリの［Sign-in redirect URIs（サインインリダイレクトURI）］を入力します。対象のorgではなく、アプリがある場所のURIを入力します。たとえば、本番orgからOktaプレビューorgに接続するときは、https://oauth.workflows.okta.com/oauth/okta/cbを使用します。

  7. ［Save（保存）］をクリックします。

アプリが作成され、［Applications（アプリケーション）］ページに表示されます。

OIDC Webアプリの構成

  1. Admin Consoleで［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。

  2. 新たに作成されたアプリケーションを選択します。

  3. ［General（一般）］タブで、［Edit（編集）］をクリックします。

  4. ［Allowed Grant Types（許可される付与タイプ）］リストで、［Refresh Token（リフレッシュトークン）］を選択します。

  5. ［Save（保存）］をクリックします。

  6. ［Assignments（割り当て）］タブを選択し、［Edit（編集）］をクリックします

  7. アプリを適切なユーザーに割り当てます。個別の人またはグループに割り当てることができます。

    ユーザーには継続的なスーパー管理者権限が必要です。

  8. 割り当てを保存します。

  9. ［Okta APIのスコープ］タブで、ユースケースに必要なスコープの同意を付与します。「Oktaコネクターに関するガイダンス」を参照してください。

  10. ［Save（保存）］をクリックします。

アプリは設定され、割り当てられたユーザーはこのorgの接続を作成できます。

対象のOkta orgのアカウントの認可

開始する前に

  • 以前の手順で作成したOpenID Connect Webアプリに割り当てられている必要があります。

  • Okta Workflows OAuthアプリで必要なスコープが付与されている必要があります。「スコープの付与または取り消し］を参照してください。

  • スーパー管理者資格情報を持っている必要があります。

    コネクターの初期認可に加え、この接続の再承認にはOktaスーパー管理者、ワークフロー管理者、または接続マネージャーの権限を持つアカウントが必要です。

  • Oktaアカウントの認可には次の情報も必要です。

    • ［Domain（ドメイン）］：Okta orgのドメイン。URLからhttps://プレフィックスまたは-admin部分を除いたもの。たとえば、Okta Admin ConsoleのURLがhttps://yourcompany.okta.comである場合、ドメインはyourcompany.okta.comです。

    • ［Client ID（クライアントID）］と［Client Secret（クライアントシークレット）］：これは、OpenID Connectアプリで確認できるクライアントIDとクライアントシークレットの値です。これらの値を確認する方法は次のとおりです。

      1. Admin Consoleで［Applications（アプリケーション）］［Applications（アプリケーション）］に移動します。

      2. 自分のOpenID Connect Webアプリを開きます。

      3. ［サインオン］タブをクリックし、［Client ID（クライアントID）］と［Client secret（クライアントシークレット）］の値を接続詳細にコピーします。

手順

  1. Okta Workflowsコンソールで［Connections（接続）］に移動します。

  2. ［New Connection（新規接続）］をクリックすると、利用できるすべてのコネクターがリスト表示されます。

  3. Oktaコネクターを選択します。

  4. ［New Connection（新規接続）］ウィンドウで、［Connection Nickname（接続ニックネーム）］を入力します。これは、接続リストに表示される表示名です。

  5. ［Domain（ドメイン）］、［Client ID（クライアントID）］、［Client Secret（クライアントシークレット）］の値を入力します。

  6. ［Permissions（権限）］タブをクリックし、［Use default scopes（デフォルトスコープを使用）］または［Customize scopes (advanced)（スコープをカスタマイズ（高度））］を選択します。

    • ［Use default scopes（デフォルトスコープを使用）］：このオプションには、任意のOktaコネクターカードの実行に必要なスコープが含まれます。

    • ［Customize scopes (advanced)（スコープをカスタマイズ（高度））］：この接続のスコープをカスタマイズする場合は、このオプションを選択します。デフォルトのスコープリストにない［Manually add scopes（スコープを手動で追加）］することもできます。存在しないスコープなどの無効なスコープの追加を試みると、接続の作成は失敗します。

    スコープを付与するには：接続を作成する前に、Okta Workflows OAuthアプリでそれらのスコープを付与し、この［権限］タブでスコープを選択します。

    スコープを取り消すには：接続を作成する前に、OAuthアプリからそれらのスコープを取り消すか、付与し、［権限］タブで選択したスコープを消去します。

    OAuthアプリでスコープを付与しない場合でも接続を作成または再認可できますが、その接続にはそれらの付与されていないスコープは含まれません。

    必要なスコープなしでカードを実行しようとすると、不十分なスコープエラーが発生します。

  7. ［Create（作成）］をクリックします。

［Connections（接続）］リストに新しい接続が表示されます。

接続の再承認

既存の接続にスコープの変更を反映させるには、接続を再承認する必要があります。

スコープを変更せずに既存の接続を再承認すると、単に前回の承認のスコープが継承されます。

関連項目

Oktaコネクター

Workflows要素

Oktaコネクターに関するガイダンス

Okta APIドキュメント