アクションフローでのOktaアクションの使用

現在のプランを確認

Suite、すべてのバージョン

Team、Growth、Professional、EnterpriseまたはEnterprise Plus

Support

Team、ProfessionalまたはEnterprise

検証済みのAI要約◀▼

Oktaをアクションフローに接続すると、ユーザーの作成、更新、有効化、無効化、グループメンバーシップの管理といったユーザー管理タスクを自動化できます。安全に接続するために専用のサービスアカウントを使用し、必要なスコープを許可します。このインテグレーションにより、ベストプラクティスに従ってセキュリティを維持しながら、プロセスを効率化し、プラットフォーム間のコラボレーションを強化できます。

アクションビルダーをOktaなどの外部システムに接続すると、管理者は自動化ワークフロー内でZendeskを外部システムと連携させることができます。これにより、コラボレーションを強化し、複数のプラットフォームにまたがるシームレスな体験を維持できます。

メモ：アクションフロー内の外部システムに関連するステップは、総称して「外部アクション」と呼ばれます。

この記事では、以下のトピックについて説明します。

• Oktaをアクションビルダーに接続する
• アクションフローでのOktaアクションの使用

Oktaをアクションビルダーに接続する

外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。

外部システムに接続して外部アクションをアクションフローで使用する場合は、以下のベストプラクティスをお勧めします。

• アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
• すべてのインテグレーションで、必要なスコープへアクセスできる必要があります。ただし、外部システムへの接続を許可する前に、スコープを確認し検証することが重要です。
• APIキーを使用するツール（OpenAIなど）の資格情報を管理する場合、キーをセキュアな保管場所または資格情報管理ツールに保存することが最適です。

ステップ1：OktaでOAuthアプリケーションを作成する

1. 管理者としてOkta管理コンソールにサインインします。
2. 「Applications」>「Applications」に移動します。
3. 「Create App Integration」をクリックします。
4. 「OIDC - OpenID Connect」を選択し、次に「Web Application」を選択します。
5. アプリケーションを設定します。
   • App integration name：わかりやすい名前を入力します（「Zendeskアクションフローコネクタ」など）。
   • Grant type：Authorization Codeを選択します。
   • Sign-in redirect URI：https://zis.zendesk.com/api/services/zis/connections/oauth/callback を入力します。
   • Sign-out redirect URI：https://zis.zendesk.com/api/services/zis/connections/oauth/callback を入力します。
   • Controlled access：適切なユーザーとグループを割り当てます。
6. 「Save」をクリックします。
7. 保存後、生成された以下の2つの値を必ず記録してください。
   • クライアントID
   • クライアントシークレット
8. 「Security」>「API」>「Authorization Servers」に移動し、OktaドメインのURLを確認して記録してください。

ステップ2：管理センターでOktaコネクタを設定する

1. 管理センターで、サイドバーにある「 アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。
2. アクションフローを新規作成するか、既存のアクションフローを編集します。
3. ステップサイドバーを開きます。
4. 「外部アクション」セクションで、「Okta」をクリックします。
5. 「接続」をクリックします。
6. 以下の値をそれぞれのフィールドに入力します。
   • クライアントID
   • クライアントシークレット
   • OktaのベースURL（Oktaドメインの例：https://your-domain.okta.com）
7. Oktaの指示に従って認証を行い、接続を確立します。

   OAuth接続プロセス中に、openid、okta.users.read、okta.users.manage、okta.groups.read、okta.groups.manageのスコープと権限を承認する必要があります。

   メモ：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。

接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細情報、およびOktaで利用可能なアクションが表示されます。

重要：Oktaコネクタは、IDおよびアクセス管理システムと直接やり取りし、機密性の高い認証および承認情報を扱うため、慎重に使用してください。設定ミスや不適切な使用は、不正アクセス、情報漏えい、またはプラットフォームのセキュリティ侵害につながる可能性があります。最小権限の原則や安全な認証情報管理など、セキュリティのベストプラクティスに従ってください。

アクションフローでのOktaアクションの使用

Oktaアクションのステップを使用して、ユーザーの管理、アカウントのアクティブ化または非アクティブ化、およびグループメンバーシップの管理を行うことができます。

以下のOktaアクションを選択できます。

• ユーザーを作成する
• ユーザープロフィールを更新する
• ユーザーをアクティブにする
• ユーザーを非アクティブにする
• ユーザーをグループに追加する
• ユーザーをグループから削除する
• ユーザーを検索する
• グループを検索する

ユーザーを作成する

「ユーザーを作成する」アクションを使用してユーザーを作成します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：First name、Last name、Login、Email オプション：Activate user、Password
出力	id, First name, Last name, Email, Status などのユーザー情報

ユーザープロフィールを更新する

「ユーザープロフィールを更新する」アクションを使用してユーザープロフィールを更新します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：User ID オプション：First name、Last name、Login、Email
出力	id, First name, Last name, Email, Status などのユーザー情報

ユーザーをアクティブにする

「ユーザーをアクティブにする」アクションを使用してユーザーをアクティブにします。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：User ID
出力	Success（true または false）

ユーザーを非アクティブにする

「ユーザーを非アクティブにする」アクションを使用してユーザーを非アクティブにします。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：User ID
出力	Success（true または false）

ユーザーをグループに追加する

「ユーザーをグループに追加する」アクションを使用して、ユーザーをグループに追加します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Group ID、User ID
出力	Success（true または false）

グループからユーザーを削除する

「グループからユーザーを削除する」アクションを使用して、グループからユーザーを削除します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	必須：Group ID、User ID
出力	Success（true または false）

ユーザーを検索する

「ユーザーを検索する」アクションを使用してユーザーを検索します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	Login/EmailまたはUser ID
出力	id, First name, Last name, Email, Status などのユーザー情報

グループを検索する

「グループを検索する」アクションを使用してグループを検索します。

このアクションには以下の入力と出力が含まれます。

	変数
入力	Group IDまたはGroup name
出力	Success（true または false）