Configurer les appels de gestion du cycle de vie de l'agent pour Okta Privileged Access

Les appels de cycle de vie Okta Privileged Access exposent un bus d‘événements sur vos serveurs qui est notifié lorsqu‘un administrateur met à jour les utilisateurs en local et les configurations de groupe. Les administrateurs Okta Privileged Access peuvent personnaliser ces appels de cycle de vie grâce à des scripts qui s‘adapteront à toutes les tâches de routine devant être exécutées lorsque ces modifications sont apportées. Les appel exécutent des scripts pour tous les fichiers correspondants dans le répertoire des appels configurés. Vous pouvez découvrir quels objets du système d‘exploitation sont affectés en fonction de l‘événement et voir quels scripts sont en cours d‘exécution. Voir la page dédiée aux Répertoires et scripts et aux Variables d'environnement relatives au cycle de vie.

Option de configuration

L‘option AccountLifecycleHooksDir dans sftd.yaml spécifie le répertoire depuis lequel l‘agent Okta Privileged Access charge les scripts d‘appel de cycle de vie. Les chemins par défaut suivants s‘appliquent si cette option n‘est pas définie :

Pour remplacer les paramètres par défaut, ajoutez l‘option AccountLifecycleHooksDir à sftd.yaml avec le chemin d‘accès au répertoire de vos appels :

AccountLifecycleHooksDir: /path/to/your/hooks

Procédure

Les étapes suivantes vous permettront de configurer le serveur hôte pas-à-pas.

Créer un script personnalisé

1. Depuis la ligne de commande, utilisez SSH pour vous connecter à l'un des serveurs Linux cibles.

2. Passez en mode root en exécutant la commande sudo su.

3. Créez un nouveau répertoire pour le script hooks en utilisant la commande suivante :

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

4. À l'aide d'un éditeur de texte, créez un nouveau fichier portant le nom 01-copyfiles.sh et copiez-collez le script bash suivant :

   Remarque : l'exemple ci-dessous présente les fonctionnalités de base des appels de cycle de vie de l'agent. Si nécessaire, modifiez le script pour qu'il corresponde à votre propre intégration.

   #!/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. Accordez au script la permission d'accéder à l'exécution :

   chmod 755 01-copyfiles.sh

6. Exécutez la commande ls -l et vérifiez que les permissions ont bien été configurées. Le résultat doit être le suivant :

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

Créer des fichiers source

1. Créez un répertoire pour les fichiers source en exécutant les commandes suivantes :

   cd /opt
   mkdir sourcefiles

2. Créez ensuite les fichiers source à l'aide des commandes suivantes :

   cd sourcefiles
   touch App1 App2 App3

3. Exécutez la commande ls et vérifiez que les fichiers App1, App2, et App3 ont bien été créés.

Créer un utilisateur Okta et l'affecter à un groupe autorisé

1. En tant qu'administrateur Okta, accédez au Admin Dashboard du Tenant Okta qui gère votre application Okta Privileged Access.
2. Accédez à Applications et cliquez sur Okta Okta Privileged Access .
3. Cliquez sur Affectations, puis sur Groupes. Mémorisez le nom du groupe qui a été affecté à l'application.
4. Dans l'Admin Console Okta, sélectionnez Directory, Personnes puis Ajouter une personne.
5. Créez un utilisateur et donnez-lui un nom facile à mémoriser.
6. Dans l'Admin Console Okta, accédez au Directory puis cliquez sur Groupes. Lorsque vous serez sur cette page, sélectionnez le groupe qui a été affecté à Okta Privileged Access à l'étape 3.

Valider l'approvisionnement des utilisateurs sur votre serveur Linux

1. Depuis l'invite de commande Linux, saisissez les commandes suivantes :

   cd /home
   ls -l

2. Vérifiez que le répertoire personnel de votre nouvel utilisateur a bien été créé.

3. Basculez vers le répertoire personnel du nouvel utilisateur en exécutant cd <username>.

   Vous pouvez vérifier que les fichiers App1, App2 et App3 existent bien dans le répertoire personnel de l'utilisateur à l'aide de la commande ls.

Ces étapes vous permettront d'utiliser l'agent des appels de cycle de vie de Okta Privileged Access pour que vos utilisateurs et groupes puissent intégrer des automatisations, systèmes ou répertoires d'utilisateur externe en hôte local dans Okta.

Informations liées

Répertoires et scripts

Les répertoires et scripts suivants sont appelés en fonction de l‘événement utilisateur survenu. Les chemins affichés utilisent le répertoire de base par défaut de Linux et macOS. Si AccountLifecycleHooksDir est défini dans sftd.yaml, le répertoire de base diffère en conséquence. Le type d'événement est contenu dans la variable SFT_HOOK_EVENT. Consultez Variables d'environnement relatives au cycle de vie.

• user-created

  Lorsqu'un utilisateur est créé, les scripts sont exécutés dans le répertoire suivant : /usr/lib/sftd/hooks/user-created.d/*.sh.

• user-updated

  Lorsqu'un utilisateur est mis à jour, les scripts sont exécutés dans le répertoire suivant : /usr/lib/sftd/hooks/user-updated.d/*.sh.

• user-deleted

  Lorsqu'un utilisateur est supprimé, les scripts sont exécutés dans le répertoire suivant : /usr/lib/sftd/hooks/user-deleted.d/*.sh.

Variables d'environnement relatives au cycle de vie