認可
Oktaアカウントへの接続を作成し、このコネクターを認可します。この接続は、このコネクターで次にフローを構築するときに再利用できます。
推奨されるベストプラクティスは、Okta Workflowsのスーパー管理者資格情報を使って特定のサービスアカウントを作成してから、そのアカウントを使って接続を認可することです。それ以外の場合、接続のセットアップに使用するOktaユーザーアカウントは、Okta Workflowsによって実行されるすべてのアクションと関連付けられます。
開始する前に
-
アカウントはスーパー管理者資格情報を持っている必要があります。
注:コネクターの初期認可に加え、この接続の再承認にはOktaスーパー管理者、Workflows管理者、または接続マネージャーの権限を持つアカウントが必要です。
-
スーパー管理者は、接続を作成するアカウントにOkta Workflows OAuthアプリを割り当てる必要があります。
-
Okta Realmsのレポートを生成コネクターには、Okta Identity Governanceまたは外部ユーザーが必要です。「アイデンティティガバナンス(Identity Governance)」または「セキュアパートナーアクセス」を参照してください。
手順
Okta Realmsのレポートを生成接続を作成するには、以下の複数のタスクを実行します。
ドメイン名を記録する
Okta Oktaの右上隅にあるユーザー名をクリックしてOktaドメインを見つけます。Admin Consoleドメインはドロップダウンメニューに表示され、以下の例のいずれかに類似したものになります。
-
example.okta.com -
example.okta-emea.com -
example.oktapreview.com
アプリの認証値を記録する
Okta Workflows OAuthアプリケーションのクライアントID(Client ID)とクライアントシークレット(Client Secret)が必要です。
-
Admin Consoleで、に移動します。
-
Okta Workflows OAuthアプリを開きます。
-
サインオン(Sign On)タブをクリックし、クライアントID(Client ID)とクライアントシークレット(Client secret)の値をコピーします。
スコープを付与する
Okta Workflows OAuth アプリケーションにいる間に次の手順を実行します。
-
Okta APIスコープ(Okta API Scopes)タブをクリックして利用可能なスコープの一覧を表示します。
-
付与するスコープごとに付与(Grant)をクリックします。「Okta Realmsのレポートを生成コネクターカードのスコープ」を参照してください。
既存の接続にスコープの変更を反映させるには、接続を再承認する必要があります。
Okta Workflowsで接続を作成する
-
Okta Workflowsコンソール で接続(Connections)に移動します。
-
新規接続(New Connection)をクリックすると、利用できるすべてのコネクターがリスト表示されます。
-
Okta Realmsのレポートを生成コネクターを選択します。
-
新規接続(New Connection)ウィンドウで接続ニックネーム(Connection Nickname)を入力します。これは、接続リストに表示される表示名です。
-
Okta orgのドメイン(Domain)を入力します。
-
クライアントID(Client ID)とクライアントシークレット(Client secret)(Client Secret)を入力します。
-
権限(Permissions)タブをクリックし、デフォルトスコープを使用(Use default scopes)またはCustomize scopes (advanced)(スコープをカスタマイズ(高度))を選択します。
-
デフォルトスコープを使用(Use default scopes):このオプションには、任意のOktaコネクターカードの実行に必要なスコープが含まれます。
-
Customize scopes (advanced)(スコープをカスタマイズ(高度)):この接続のスコープをカスタマイズする場合は、このオプションを選択します。
スコープを付与するには:接続を作成する前に、 Okta Workflows OAuthアプリでそれらのスコープを付与し、この権限(Permissions)タブでスコープを選択します。
スコープを取り消すには:接続を作成する前に、OAuthアプリからそれらのスコープを取り消すか、付与し、権限(Permissions)タブで選択したスコープを消去します。
OAuthアプリでスコープを付与しない場合でも接続を作成または再承認できますが、その接続にはそれらの付与されていないスコープは含まれません。
注:必要なスコープなしでカードを実行しようとすると、不十分なスコープ(Insufficient Scope)エラーが発生します。
-
-
作成(Create)をクリックします。
接続(Connections)リストに新しい接続が表示されます。
接続の再認可
既存の接続にスコープの変更を反映させるには、接続を再承認する必要があります。
スコープを変更せずに既存の接続を再承認すると、単に前回の承認のスコープが継承されます。