Advanced Server AccessにエージェントのLifecycle Managementフックを構成する

Advanced Server Accessライフサイクルフックは、管理者がローカルユーザーとグループの構成を更新したときに通知を受信するサーバー上のイベントバスを公開します。Advanced Server Access管理者は、スクリプトを使用してこれらのライフサイクルフックをカスタマイズして、これらの変更が行われたときに実行する必要のあるルーチンタスクに適合させることができます。フックは、構成されたフックディレクトリ内の、一致するすべてのファイルに対してスクリプトを実行します。イベントに応じて影響を受けるオペレーティングシステムのオブジェクトを検出し、どのスクリプトが実行されているかを確認できます。ディレクトリとスクリプトとライフサイクル関連の環境変数をご覧ください。

構成

sftd.yaml内のAccountLifecycleHooksDirオプションは、Advanced Server Accessエージェントがライフサイクルフックのスクリプトを読み込むディレクトリを指定します。このオプションが設定されていない場合は、次のデフォルトパスが適用されます。

デフォルト設定を上書きするには、AccountLifecycleHooksDirオプションをsftd.yamlに追加し、フックディレクトリへのパスを指定します。

AccountLifecycleHooksDir: /path/to/your/hooks

手順

以下の手順は、ホスト上のセットアップを実行するためのガイドとして利用してください。

カスタムスクリプトを作成する

1. コマンドラインから、SSHを使用してターゲットLinuxサーバーの1つに接続します。

2. sudo suを実行してrootに切り替えます

3. 次のコマンドでフックスクリプト用のディレクトリを作成します。

   mkdir -p /usr/lib/sftd/hooks/user-created.d

4. テキストエディターで01-copyfiles.shという名前のファイルを作成し、次のbashスクリプトをコピーして貼り付けます。

   注： 次の例では、エージェントライフサイクルフックの基本的な機能を示します。必要に応じて、特定の統合に適合するよう、スクリプトを変更します。

   #!/bin/bash
   SOURCE_FILES=/opt/sourcefiles
   cp $SOURCE_FILES/App?/home/"${SFT_HOOK_USERNAME}"
   if [ $? -eq 0 ]
   then
   echo "Successfully copied source files into /home/"${SFT_HOOK_USERNAME}"" >> /tmp/sourcefiles.out
   else
   echo "Error Copying source files into /home/"${SFT_HOOK_USERNAME}"" >> /tmp/sourcefiles.out

5. スクリプト実行のアクセス権限を許可する：

   chmod 755 01-copyfiles.sh

6. ls -lコマンドを実行し、権限が正しく設定されていることを確認します。出力は次のようになります：

   -rwxr-xr-x 1 root root 316 Jun 30 14:54 01-copyfiles.sh

ソースファイルを作成する

1. 次のコマンドを実行して、ソースファイル用のディレクトリを作成します。

   cd /opt
   
   mkdir sourcefiles

2. 次に、以下のコマンドでソースファイルを作成します。

   cd sourcefiles
   touch App1 App2 App3

3. lsコマンドを実行して、App1、App2、App3ファイルが作成されていることを確認します。

Oktaユーザーを作成して承認されたグループに割り当てる

1. Advanced Server Accessアプリケーションを管理するOktaテナントの 管理者ダッシュボード にOkta管理者として移動します。

2. アプリケーション（Applications） に移動し、 Okta Advanced Server Access をクリックします。

3. 割り当て（Assignments）、グループ（Groups）の順にクリックします。アプリケーションが割り当てられているグループの名前を記憶してください。

4. Admin Consoleでディレクトリ（Directory）、ユーザー（People）、ユーザーを追加する（Add Person）の順に選択します。

5. 覚えやすい名前でユーザーを作成します。

6. Admin Consoleでディレクトリ（Directory）に移動し、グループ（Groups）をクリックします。手順3でAdvanced Server Accessに割り当てられたグループをここから選択します。

グループをプロジェクトに追加する

1. Admin Consoleで、マイアプリケーション（My Applications）をクリックし、 Okta Advanced Server Access を選択します。

2. プロジェクト（Projects）をクリックします。

3. グループを追加するプロジェクトを選択します。

4. グループ（Groups）タブをクリックし、グループをプロジェクトに追加する（Add Group to Project）をクリックします。

5. グループ（Group）フィールドで、追加するグループの名前を入力し、グループを選択してグループを作成する（Create Group）をクリックします。

6. プロジェクトにユーザーが追加されたことを確認します。プロジェクトのユーザー（Users）タブをクリックしてユーザーを探します。

Linuxサーバーでのユーザーのプロビジョニングを検証する

1. Linuxコマンドプロンプトで次のコマンドを入力してください。

   cd /home
   ls -l

2. 新しいユーザーのホームディレクトリが作成されていることを確認します。

3. cd <username>を実行して、新規ユーザーのホームディレクトリに切り替えます。

   lsコマンドを使用して、ユーザーのホームディレクトリにApp1、App2、App3ファイルが存在することを確認できます。

ここでは、Advanced Server Accessエージェントのライフサイクルフックを使用して、ホスト-ローカル自動化、システム、外部ユーザーディレクトリをOktaのユーザーとグループに統合する方法を示します。

関連情報

ディレクトリとスクリプト

以下のディレクトリとスクリプトが、発生したユーザーまたはグループのイベントに応じて呼び出されます。示されるパスでは、デフォルトのLinuxおよびmacOSベースディレクトリが使用されます。AccountLifecycleHooksDirがsftd.yamlで設定されていると、ベースディレクトリはそれに応じて異なります。イベントタイプはSFT_HOOK_EVENT変数にキャプチャされます。ライフサイクル関連の環境変数をご覧ください。

ユーザー

• user-created

  ユーザーが作成されると、/usr/lib/sftd/hooks/user-created.d/*.sh内のスクリプトが実行されます。

• user-updated

  ユーザーが更新されると、/usr/lib/sftd/hooks/user-updated.d/*.sh内のスクリプトが実行されます。

• user-deleted

  ユーザーが削除されると、/usr/lib/sftd/hooks/user-deleted.d/*.sh内のスクリプトが実行されます。

グループ

• group-created

  グループが作成されると、/usr/lib/sftd/hooks/group-created.d/*.sh内のスクリプトが実行されます。

• group-updated

  グループが更新されると、/usr/lib/sftd/hooks/group-updated.d/*.sh内のスクリプトが実行されます。

• group-deleted

  グループがプロビジョン解除されると、/usr/lib/sftd/hooks/group-deleted.d/*.sh内のスクリプトが実行されます。

ライフサイクル関連の環境変数

ユーザー

グループ