Okta Workflowsチュートリアル:ユーザーが一時停止されたときに通知する

作者について

Max Katz

Staff Developer Advocate, Okta Workflows

Max Katz is a Staff Developer Advocate for Okta Workflows. Max loves the no-code automation space and creating educational content. Before Okta, Max led the North America Developer Advocacy team at IBM. Before IBM, Max led developer advocacy for a cloud-based mobile app platform, Appery, helping it grow from zero to over 400,000 developers. Max regularly writes on his http://maxkatz.net blog. 

10 3月 2023 読了目安時間: ~

A person sits at a desk in a contemporary office setting, surrounded by organized shelves and office supplies

Okta Workflowsは、アイデンティティプロセスを自動化するためのノーコードプラットフォームです。

このステップバイステップのチュートリアルでは、Oktaでユーザーが一時停止されたときに通知を送信する、ノーコードのワークフローを作成する方法を説明します。

学習内容:

  • 初めてのフローの作成方法
  • ユーザーが一時停止されたときにフローをトリガーする方法
  • ユーザーが一時停止されたときにメールを送信する方法についてご案内します
  • 個々のカードとフローのテスト方法

作成するフローは次のようになります。

Okta Workflows diagram showing a three-step automated email notification when a user account is suspended. ユーザーの一時停止通知フロー

Okta Workflowsとは?

Okta Workflowsは、アイデンティティプロセスの自動化を可能にするノーコードプラットフォームです。例えば、IT部門や開発者に依頼することなく、次のようなワークフローを構築できます。

  • 不審なアクティビティが検出された場合は、パスワードをリセットしてエンドユーザーのセッションを終了します。
  • アプリケーションへのユーザーアクセス権を付与または削除します。
  • Okta組織でイベントが発生したときに通知(Slack、eメール)を送信します。
    • このチュートリアルでは、ユーザーが一時停止されるイベントが発生した場合のフローを実行します。
  • 基本的なレポートを作成してください。

実現可能なことの簡易なリストを以下に示します。

Okta Workflowsへのアクセス

このチュートリアルを完了するには、Workflowsへのアクセス権が必要です。

Workflowsにアクセスするには、2つの方法があります。

  1. 特定のOkta製品をすでにご利用のお客様は、Workflowsをご利用いただける場合があります。
  2. WIC(Workforce Identity Cloud)トライアルの一環としてWorkflowsにアクセスできます。

他のOkta製品を使用する際のWorkflows

Okta SSO(シングルサインオン)またはOkta UD(Universal Directory)をご利用のお客様は、Workflowsをご利用いただける場合があります。[Okta organization(Okta org)]>[Admin(管理)]>[Workflows]>[Workflows console(Workflowsコンソール)]に移動して、Workflowsにアクセスできるかどうかを確認します。

これらの製品をご利用で、Workflowsにアクセスできない場合は、担当のアカウント管理者までご連絡ください。または、私に直接ご連絡いただければ、サポートさせていただきます。

WIC(Workforce Identity Cloud)トライアルの一部としてのOkta Workflows

Workforce Identity Cloudのトライアルに申し込むには:

  1. Okta Workforceのトライアルページにアクセスします。
  2. WICのトライアルに登録して、Workflowsにアクセスしてください。

Okta Workflowsコンソールを開きます

Workflowsにアクセスするには:

  1. Okta orgにサインインします。
    • トライアルをご利用の場合、orgのURLは、Oktaアカウントのアクティベーションメールに記載されています。
    • URLの形式は https://trial-<ID>.okta.comです(例:https://trial-6093533.okta.com)。
  2. [Admin(管理)](右上)をクリックして、管理コンソールにアクセスします。
  3. [Workflows]>[Workflows console(Workflowsコンソール)]の順にクリックすると、右側のメニューにWorkflowsが開きます。

Workflowsのホームページが表示されます。

Okta Workflows home dashboard displaying "Welcome to Workflows" with learning video tiles, usage metrics, and resource links. Workflowsのホームページ

フローの作成

フローの作成手順は次のとおりです。

  1. 新しいフローを作成する
  2. フローを実行するイベントを設定する

新しいフローを作成する

  1. Workflowsコンソールで、[Flows(フロー)]をクリックします。
  2. Default Folderで+ New Flowをクリックして、新しいフローを作成します。
  3. 左上の[Unnamed(名前なし)]をクリックします。
  4. 名前には「User Suspended Notification(ユーザー一時停止通知)」と入力します。
  5. 説明には、「This flow sends a notification when a user is suspended」(ユーザーが一時停止されたときに通知を送信するフロー)と入力します。
  6. [Save all data that passes through the Flow?(フローを通過するすべてのデータを保存しますか?)]のチェックボックスもオンにします。この機能は、このチュートリアルの最後で使用します。
"Edit properties" pop-up dialog in Okta Workflows for setting the "User Suspended Notification" flow name and description. ユーザーの一時停止通知フロー
  • [Save(保存)]をクリックして、フロー名と説明を保存します。

これで、最初のフローが作成されました。

Okta Workflows builder canvas for "User Suspended Notification" showing empty "Add event" and "Add app action" placeholders. 新規フロー

このセクションでは、ユーザーが一時停止されたときにフローを呼び出す方法について説明します。

フローを実行するイベントを設定する

ユーザーが一時停止されたときにフローを実行します。

フローを実行するイベントを追加するには:

  1. [When this happens(このイベントが発生したとき)]と表示されているボックスで、[Add event(イベントを追加)]をクリックします。
  2. アプリのリストから[Okta]を選択します。
  3. [Okta]のイベントメニューで、[User Suspended(ユーザーの一時停止)]イベントを探して選択します(イベントは検索できます)。
Okta event selector popup showing options filtered by "Sus", including "User Suspended." フローを実行するイベントの選択

初めてフローを作成する場合、またはOktaへの接続がない場合は、次の画面が表示され、Oktaへの接続を作成する必要があります。

Okta "User Suspended" card prompt to create a new connection in Okta Workflows. Oktaに接続します

Oktaへの接続がすでに確立されている場合は、その接続を使用してください。次のセクションに進んでください。

Oktaへの接続を設定する

  1. [+New Connection(+新しい接続)]をクリックします。
  2. [Connection Nickname(接続のニックネーム)]には「Okta Connection」と入力します。
  3. [Domain(ドメイン)]フィールドにhttp://を付けずにドメイン名を入力します。
    • 例:trial-6093533.okta.com
  4. 新しいブラウザのタブでOktaの[Admin Console(管理コンソール)]を開き、[Applications(アプリケーション)]>[Applications(アプリケーション)]に移動します。
  5. [Okta Workflows OAuth]をクリックします。
  6. [Sign On(サインオン)]タブをクリックします。
  7. [Client ID(クライアントID)]をコピーします。
  8. [Workflows]に戻り、[Client ID(クライアントID)]フィールドに貼り付けます。
  9. [Client Secret(クライアントシークレット)]をコピーします。
  10. [Workflows]に戻り、[Client Secret(クライアントシークレット)]フィールドに貼り付けます。
  11. [Create(作成)]をクリックして、Oktaへの接続を作成します。
"New Connection" pop-up dialog in Okta Workflows configured with Okta domain, Client ID, and Client Secret. Okta接続の設定

ユーザー一時停止イベントを含むフロー

フローは次のようになります。

Okta Workflows diagram showing the "User Suspended" event card added with a "Then do this" prompt. ユーザーの一時停止イベントを含むフロー

Workflowsはこのイベント(ユーザーの一時停止)を監視し、組織内でユーザーが一時停止されると、このフローが呼び出されます。

[User Suspended(ユーザーの一時停止)]カードに表示される出力フィールドは、イベントが発生したときにカードが利用可能にする情報です。他のフローステップでいずれかのフィールドを使用できます。

次のセクションでは、メールで共有するメッセージを作成します。

メールのメッセージを作成する

メッセージを作成するには、Compose(作成)カードを使用します。

前のセクションでは、イベントがフローを呼び出す仕組みについて学習しました。フローの他のコンポーネントは、アプリのアクションと関数です。

  • アプリのアクション-GmailやSlackなどのサービスを制御する処理です。
  • Function – フロー内のデータを操作、変更、または制御するためのステップ。

Compose(作成)カードを追加するには:

  1. [Add function(関数を追加)]をクリックします。
  2. [Text(テキスト)]カテゴリを選択し、[Compose(作成)]機能を選択します。
  3. [Compose(作成)]カードに、次のように入力します。
    Hello,

    次のユーザー名のユーザーが利用停止になりました。

  4. [User Suspended(ユーザーの一時停止)]カードで、[Okta User(Oktaユーザー)]>[Alternative ID](代替ID)を探します。
  5. [User Suspended(ユーザーの一時停止)]カードの[Alternate ID(代替ID)]フィールドをドラッグして、[Compose(作成)]カードの「suspended:」という単語の後に接続します。
  6. [保存]をクリックしてフローを保存します。
Animated GIF showing how to connect and map fields from the Okta User Suspended event card to a Text Compose card. カードにデータを渡す

フローは次のようになります。

Okta Workflows diagram showing an Alternate ID field mapped from a User Suspended event into a text Compose card. ユーザーの一時停止フロー

Composeカードのテスト

Workflowsの優れた機能の1つに、カードを個別にテストする機能があります。

[Compose(作成)]カードで、カードの下部にある再生ボタン ▶️ をクリックします。2番目のフィールドにサンプルデータを入力し、[Test(テスト)]をクリックしてカードの出力を確認します。

Test "Compose" pop-up dialog in Okta Workflows showing a template and generated text for a user suspension message. カードのテスト

フローの作成中に各カードを個別にテストすることをお勧めします。

次のセクションでは、eメール通知を送信するためのカードを追加します。

メール通知の送信

このステップでは、Gmailカードを追加してメールを送信します。

Gmailカードを使用してメールを送信する

[Gmail – Send Email(Gmail – メールの送信)]カードを追加する手順:

  1. [Add app action(アプリアクションを追加)]をクリックします。
  2. Gmailアプリを探します。
  3. [Send Email(メールの送信)]アクションを見つけてクリックします。
  4. Gmailカードを初めて使用する場合は、[+New Connection(+新しい接続)]をクリックし、手順に従ってGmailアカウントを認証します。
    • このカードを使用するには、Google Workspaceアカウントへのアクセス権が必要です(個人のGmailアカウントは使用できません)。

[Send Email(メールの送信)]カードは次のようになります。

Gmail "Send Email" action card configuration panel in Okta Workflows. Gmail Send Emailカード

次に、[Send Email(メールの送信)]カードのフィールドを設定する必要があります。

  1. [Email(メール)]フィールドに、ご自身のメールアドレス(または確認可能なその他のメールアドレス)を入力します。
  2. [Subject(件名)]フィールドに「User suspended」と入力します。
  3. [Body(本文)]フィールドについては、[Compose(作成)]カードの[output(出力)]フィールドを、[Send Email(メールの送信)]カードの[Body(本文)]フィールドにドラッグ&ドロップします。
  4. その他のフィールドはすべて任意です。
    • 非表示にする場合は、Gmailカードで⚙️ >[Choose fields(フィールドを選択)]をクリックします。
  5. [Save(保存)]をクリックしてフローを保存します。

フローは次のようになります。

Okta Workflows diagram showing data mappings between User Suspended, Compose, and Send Email cards. Gmailカードを使用したユーザーの一時停止フロー

Gmail – Send Emailカードをテストする

[Send Email(メールの送信)]カードをテストするには:

  1. 再生ボタン ▶️ をクリックします。
  2. [To(宛先)]と[Body(本文)]には、カードのデータが事前入力されます。サンプルの[Body(本文)]フィールドに入力し、[Test(テスト)]をクリックします。
  3. [To(宛先)]フィールドに入力したメールを確認します。
Test "Send Email" pop-up dialog in Okta Workflows configured to send a "User suspended" notification email. メール送信カードのテスト

Google Workspaceにアクセスできない場合は、別のメールプロバイダーをご利用いただけます。

Office 365 Mailカードを使用してメールを送信する

このセクションは任意です。

Google WorkspaceのGmailにアクセスできない場合は、Office 365 Mailカードを使用できます。

  1. [Add app action(アプリアクションを追加)]をクリックします。
  2. Office 365 Mailアプリを見つけてクリックします。
  3. [Send Email(メールの送信)]アクションを見つけてクリックします。
  4. Office 365カードを初めて使用する場合は、[+New Connection(+新しい接続)]をクリックし、手順に従ってOffice 365アカウントを認証します。
  5. 以下のスクリーンショットに示すように、カードの各フィールドに入力します。
Okta Workflows diagram showing an automated email notification process using Office 365 Mail for suspended users. Office 365 Mailカードを使用したユーザーの一時停止フロー

この後のセクションでは、フロー全体をテストする方法について説明します。

フローのテスト

フローをテストする準備ができました。

フローをオンにする

  1. [Save(保存)]をクリックして変更を保存します。
  2. 実行するには、フローをオンにする必要があります。[Flow is OFF(フローがオフ)]ボタンのメニューを開き、トグルをスライドさせてフローをオンにします。
Okta Workflows toolbar menu showing "Flow is ON" status and data saving options enabled. フローをオンにする

フローの実行を確認するには、[Execution History(実行履歴)]タブに移動します。現在は空ですが、ユーザーが一時停止された際に、ここでフローの実行状況が表示されます。

Okta Workflows "Execution History" tab showing a "No Executions Found" message. フローの実行履歴

[Execution History(実行履歴)]タブに「Execution history is not enabled for this Flow(このフローでは実行履歴が有効になっていません)」というメッセージが表示された場合は、[Save all data that passes through the flow(フローを通過するすべてのデータを保存する)]オプションをオンに切り替えます。

Okta Workflows settings menu with toggles for turning the flow ON and saving all flow data. フローデータ保存オプション

ユーザーを一時停止する

フローをテストするには、組織内で一時停止できるユーザーが必要です。

  1. 別のブラウザのタブで、[Okta organization(Okta org)]>[Admin(管理)]>[Directory(ディレクトリ)]>[People(ユーザー)]に移動します。
  2. [Add(追加)]をクリックして、新しい人を追加します。既存の人物を使用することもできます。必須フィールドに入力し、[Save(保存)]をクリックしてください。

これは[People(ユーザー)]ページです。

Okta Admin Console Directory > People page displaying a user list with names, email addresses, and active statuses. ユーザーページ

ユーザーを一時停止するには:

  1. ユーザーをクリックします。
  2. [More Actions(その他のアクション)]>[Suspend(一時停止)]を選択してユーザーを一時停止します。

フローの実行履歴を確認する

Workflowsのブラウザタブに切り替えて、[Execution History(実行履歴)]タブを開きます。peter@atko.emailというユーザーを一時停止するフロー実行が表示されます。。

Okta Workflows Execution History view showing the completed execution details and data flow across User Suspended, Compose, and Send Email cards. 最初のフロー実行

一時停止する別のユーザーを選択すると、別のフロー実行が追加されます。このフロー実行では、ユーザーmaya@atko.emailが一時停止されます。

Okta Workflows Execution History tab showing successful automated flow runs for a suspended user event. 2回目のフロー実行

[Execution History(実行履歴)]タブを詳しく見ると、カードからカードにデータがどのように渡されるかを確認できます。より高度なフローを作成する際は、[Execution History(実行履歴)]タブを使用して実行を監視し、カード間でどのようなデータが渡されるかを確認できます。

Okta Workflows execution history view showing successful step-by-step data output for a suspended user email flow. データ接続を使用したフロー実行

このようなメールが送信されます。

Email notification stating that user maya@atko.email was suspended. ユーザーの一時停止通知メール

フローチャート

フローの概要を確認するには、[Flow Chart(フローチャート)]タブに移動します:

Okta Workflows "Flow Chart" tab showing icons for User Suspended, Compose, and Send Email steps. フローチャート

学習した内容

このチュートリアルでは、ユーザーが一時停止された際に実行され、通知のメールを送信するノーコードのワークフローを作成しました。学習した内容:

  • フローの作成方法
  • イベント(ユーザーの一時停止)に基づいてフローをトリガーする方法
  • ユーザーが一時停止されたときにメールを送信する方法についてご案内します
  • 個別のカードとフローをテストする方法

学習に役立つその他のリソース

作者について

Max Katz

Staff Developer Advocate, Okta Workflows

Max Katz is a Staff Developer Advocate for Okta Workflows. Max loves the no-code automation space and creating educational content. Before Okta, Max led the North America Developer Advocacy team at IBM. Before IBM, Max led developer advocacy for a cloud-based mobile app platform, Appery, helping it grow from zero to over 400,000 developers. Max regularly writes on his http://maxkatz.net blog. 

アイデンティティ施策を推進