Okta ​

管理者権限を持つユーザーとしてOkta組織にサインインします。

Okta 管理コンソールに移動し、アプリケーション > アプリケーションを選択します。

Create App Integrationをクリックします。

サインイン方法セクションを見つけ、OIDC - OpenID Connectを選択します。

アプリケーションタイプセクションに移動し、Webアプリケーションを選択します。

新しいWebアプリ統合ページで一意のアプリ統合名を入力します。

新しいアプリ統合を作成

トークンリクエストで所有証明（DPoP）ヘッダーを要求フィールドが選択解除されていることを確認します。

グラントタイプセクションのユーザーに代わって動作するクライアントフィールドで、次のチェックボックスを選択します。

• 認可コード
• リフレッシュトークン

サインインリダイレクトURIセクションに次のWorkatoコールバックURIを入力します: https://www.workato.com/oauth/callback

サインインリダイレクトURI

希望に応じて割り当てオプションを選択し、保存を選択します。 Oktaがアプリ統合を作成します。

一般タブに移動し、クライアントIDとクライアントシークレットをコピーして、これらの認証情報をWorkatoに入力できるようにします。

クライアントIDとクライアントシークレットをコピー

一般設定に移動し、所有証明フィールドが選択解除されていることを確認します。

Okta APIスコープタブに移動し、必要なスコープをアプリ統合に割り当てます。 コネクションには、少なくとも次のスコープが必要です。

• okta.logs.read
• okta.schemas.read

offline_accessとopenidの権限は自動的に割り当てられます。

カスタムロールを使用している場合、コネクションには次の追加スコープが必要です。

• okta.users.read

Okta APIスコープを割り当て

作成 > コネクションをクリックするか、Cを2回押します。

New connectionページで、コネクションとしてOktaを検索して選択します。

コネクション名フィールドに、コネクションの一意の名前を入力します。

コネクションに名前を付ける

ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。

Authentication typeドロップダウンメニューを使用して、Authorization code grantを選択します。

Okta domainフィールドにOktaドメイン名を入力します。 例: mycompany.okta.comまたはmytest.oktapreview.com。 入力するドメイン名に、mycompany-admin.okta.comなどの-adminが含まれていないことを確認してください。このURLはUIからOkta管理コンソールにアクセスするために使用され、OAuthエンドポイントではありません。

Client IDを入力します。

Client secretを入力します。

Advanced settingsセクションを展開し、OAuth 2.0 scopesドロップダウンメニューを使用して、このコネクション用に追加のOAuth 2.0スコープを選択します。 スコープは、OktaインスタンスのApplications > Applications > Okta API Scopesで定義されているスコープと一致している必要があります。

Workatoは、指定したスコープに加えて、最低限必要なスコープをリクエストします。 特定のスコープを選択しない場合、Workatoはデフォルトのスコープをリクエストします。

接続をクリックします。

管理者権限を持つユーザーとしてOkta組織にサインインします。

Okta 管理コンソールに移動し、アプリケーション > アプリケーションを選択します。

Create App Integrationをクリックします。

新しいアプリ統合を作成ページのサインイン方法セクションでAPIサービスを選択します。

APIサービスを選択

一意のアプリ統合名を入力し、新しいAPIサービスアプリ統合ページで保存をクリックします。

アプリ統合名を入力

編集をクリックし、クライアント認証セクションで公開鍵/秘密鍵を選択します。

公開鍵セクションに移動し、編集をクリックします。

キーを追加をクリックします。

新しいキーを生成をクリックして、新しいキーペアを生成します。

公開鍵を追加

秘密鍵セクションに移動し、PEMを選択します。

クリップボードにコピーをクリックして、秘密鍵をコピーします。 このキーをWorkatoのOktaコネクション設定に入力します。 ページを離れると、秘密鍵を再度取得することはできません。

クリップボードにコピーをクリックして秘密鍵をコピー

完了をクリックします。

新しいアプリ統合の一般タブで保存をクリックし、キーを保存して有効化します。 Workatoに接続するには、その前にキーを保存する必要があります。

既存のクライアントシークレットは使用されなくなりますというメッセージが表示された場合は、保存をクリックします。

キーのステータスがアクティブに変わったことを確認します。

General > General Settingsに移動し、Proof of possessionフィールドの選択が解除されていることを確認します。

Okta APIスコープタブに移動し、必要なスコープをアプリ統合に割り当てます。 コネクションには、次の最小スコープが必要です:

• okta.logs.read
• okta.schemas.read

カスタムロールを使用している場合、コネクションには次の追加スコープが必要です。

• okta.users.read

Okta APIスコープを割り当て

管理者ロールタブに移動し、割り当てを編集をクリックします。

ロールドロップダウンメニューを使用して、Read-only Administratorまたは該当するカスタムロールを選択します。

変更を保存をクリックします。

作成 > コネクションをクリックするか、Cを2回押します。

New connectionページで、コネクションとしてOktaを検索して選択します。

コネクション名フィールドに、コネクションの一意の名前を入力します。

コネクションに名前を付ける

ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。

認証タイプドロップダウンメニューで、クライアント認証情報を選択します。

Okta domainフィールドにOktaドメイン名を入力します。 例: mycompany.okta.comまたはmytest.oktapreview.com。 入力するドメイン名に、mycompany-admin.okta.comのような-adminが含まれていないことを確認してください。 このURLはUIからOkta管理コンソールにアクセスするために使用されるもので、OAuthエンドポイントではありません。

Client IDを入力します。

Oktaで生成した秘密鍵をPEM形式で秘密鍵フィールドに入力します。 必ず-----BEGIN PRIVATE KEY-----と-----END PRIVATE KEY-----を含めてください。

Advanced settingsセクションを展開し、OAuth 2.0 scopesドロップダウンメニューを使用して、このコネクション用に追加のOAuth 2.0スコープを選択します。 スコープは、OktaインスタンスのApplications > Applications > Okta API Scopesで定義されているスコープと一致している必要があります。

Workatoは、最低限必要なスコープに加えて、指定したスコープをリクエストします。 特定のスコープを選択しない場合、Workatoはデフォルトのスコープをリクエストします。

接続をクリックします。

Oktaにサインインします。

セキュリティ＞API＞トークンに移動します。

トークンを作成をクリックして、APIキーを生成します。 キーは、それを作成した管理者の権限を継承します。

作成 > コネクションをクリックするか、Cを2回押します。

New connectionページで、コネクションとしてOktaを検索して選択します。

コネクション名フィールドに、コネクションの一意の名前を入力します。

Okta APIキーコネクションのセットアップ

Authentication typeドロップダウンメニューを使用してAPI keyを選択します。

Okta domainフィールドにOktaドメイン名を入力します。 例: mycompany.okta.comまたはmytest.oktapreview.com。 入力するドメイン名に、mycompany-admin.okta.comなどの-adminが含まれていないことを確認してください。このURLはUIからOkta管理コンソールにアクセスするために使用され、OAuthエンドポイントではありません。

Oktaインスタンスで生成したAPIキーを入力します。

接続をクリックします。