Configurer une connexion de charges de travail
La connexion à la charge de travail est l'ancre de confiance qui établit la relation entre Okta Privileged Access et votre source d'identité de charge de travail. Vous pouvez choisir parmi trois méthodes d'authentification : l'authentification basée sur JWT (à l'aide de fournisseurs d'identité externes tels que GitHub, GitLab ou CircleCI), l'authentification basée sur l'IAM d'AWS (à l'aide de l'identité IAM d'une charge de travail disposant d'identifiants AWS) ou l'authentification basée sur une clé API (à l'aide de secrets gérés contrôlés par des administrateurs de sécurité).
Pour les connexions JWT et IAM AWS, un modèle de sécurité à répartition des tâches s'applique : un administrateur DevOps configure et teste la connexion en mode brouillon, tandis qu'un administrateur de sécurité procède à la vérification finale et fait passer la connexion au statut actif afin de permettre l'émission de jetons en production. Pour les connexions par clé API, seuls les administrateurs de sécurité créent et gèrent la connexion.
Les connexions JWT peuvent utiliser soit une configuration JWT générique, soit une intégration à un fournisseur spécifique. Bien que des intégrations spécifiques offrent une expérience de configuration plus rationalisée avec des champs prédéfinis, le mécanisme de sécurité sous-jacent reste identique. Les deux méthodes utilisent un JSON Web Token (JWT) standard comme document d'identité de la charge de travail et exigent les mêmes éléments de sécurité essentiels, tels qu'une URL JWKS et des déclarations requises, pour une validation réussie.
Avant de commencer
-
Pour les connexions de charge de travail JWT et IAM AWS : vous devez disposer d'un rôle d'administrateur DevOps pour créer un brouillon de connexion de charge de travail. Un rôle d'administrateur de sécurité est requis pour activer ou désactiver la connexion.
-
Pour les connexions des charges de travail IAM AWS : vous devez connaître l'ID du compte AWS à 12 chiffres du compte sur lequel s'exécute la charge de travail. Pour limiter la connexion à une identité spécifique, vous devez également connaître le type de ressource, le nom de la ressource et d'autres attributs de l'identité AWS utilisée par la charge de travail.
-
Pour les connexions de charge de travail par clé API : vous devez disposer d'un rôle d'administrateur de sécurité pour créer, gérer et activer la connexion.
-
Pour les connexions JWT, vous pouvez utiliser l'une des méthodes d'intégration JWT suivantes :
-
JWT générique — Vous devez fournir une source de validation JWKS et spécifier toutes les déclarations requises (telles que
iss,audetsub) pour vérifier le JWT et identifier la charge de travail. La source de validation peut être une URL JWKS ou un contenu JWKS statique que vous collez ou chargez directement. -
Fournisseur spécifique : l'interface utilisateur d'Okta offre des champs préconfigurés et une prise en charge native des structures JWT spécifiques au fournisseur. En saisissant des identifiants courants, comme un ID d'organisation pour CircleCI, Okta renseigne automatiquement les déclarations requises et, parfois, l'URL JWKS.
-
Créer une connexion JWT générique à la charge de travail
-
Sur le tableau de bord Okta Privileged Access, accédez à .
-
Cliquez sur Créer une connexion à la charge de travail.
-
Cliquez sur JWT générique.
-
Renseignez les informations suivantes :
Paramètre Action Nom de la connexion Saisissez un nom unique et adapté pour une URL. Description de la connexion
Saisissez une description.
Sélectionnez la durée de vie du jeton
Saisissez un Montant et une Unité. Ils définissent la durée de validité du jeton d'accès Okta Privileged Access une fois émis.
Informations de configuration JWT
Sélectionnez comment Okta Privileged Access récupère la clé publique pour vérifier la signature du fournisseur sur le JWT. Sélectionnez l'un des onglets suivants :
-
URL JWKS – Saisissez l'URL où Okta Privileged Access récupère les clés publiques lors de l'exécution.
-
Coller/Charger – Collez le JSON JWKS directement dans le champ ou sélectionnez un fichier à charger. Le contenu du fichier est lu dans votre navigateur et n'est pas chargé sur le serveur. La saisie doit être un objet JSON JWKS complet contenant un tableau
keyscomportant au moins une clé.
Remarque :La source de validation ne peut pas être modifiée une fois la connexion établie. Vous pouvez mettre à jour le contenu JWKS d'une connexion Coller/Charger à tout moment en sélectionnant Modifier.
Déclarations requises
Définissez les critères qui doivent être respectés dans le JWT de la charge de travail. Okta recommande d'inspecter votre JWT à l'aide d'un script de débogage ou de jwt.io.
-
Saisissez le Nom du champ source.
-
Sélectionnez le type d'opérateur :
-
Est égal à
-
Commence par
-
Existe
Si vous sélectionnez Existe, alors la saisie de la Valeur n'est pas requise.
-
-
Saisissez une Valeur.
-
Facultatif. Cliquez sur Ajouter une condition et répétez l'étape précédente.
-
-
Cliquez sur Créer une connexion à la charge de travail.
Créer une connexion à la charge de travail spécifique au fournisseur
-
Sur le tableau de bord Okta Privileged Access, accédez à .
-
Cliquez sur Créer une connexion à la charge de travail.
-
Sélectionnez votre type de connexion et remplissez les champs spécifiques au fournisseur, puis cliquez sur Suivant :
Type de connexion Champs Azure Managed Identity
Saisissez votre ID de tenant Azure.
CircleCI
- Saisissez votre ID d'organisation.
- Facultatif. Sélectionnez Périmètre pour l'ID de projet, puis saisissez l'ID.
GitHub Actions
Saisissez votre Propriétaire GitHub.
GitLab
- Saisissez le nom de votre Domaine.
- Facultatif. Sélectionnez Périmètres pour le nom du groupe, puis saisissez le nom du groupe.
- Facultatif. Sélectionnez Périmètre pour le nom du projet, puis saisissez le nom du projet.
- Facultatif. Sélectionnez Périmètre pour l'ID du projet, puis saisissez l'ID du projet.
Google Cloud Provider
- Saisissez votre ID d'app cliente.
- Facultatif. Sélectionnez Périmètre pour l'e-mail, puis saisissez l'e-mail.
- Facultatif. Sélectionnez Périmètre pour l'ID de compte, puis saisissez l'ID du compte.
Kubernetes
Saisissez l'URL de l'émetteur de votre cluster.
Azure DevOps
Saisissez l'ID Azure DevOps de votre organisation.
Buildkite
Saisissez le slug de votre organisation Buildkite.
Harness
Entrez votre cluster Harness et votre ID de compte Harness.
Jenkins
Saisissez votre URL de base Jenkins.
Pulumi ESC
Saisissez le nom de votre org Pulumi.
Bitbucket Pipelines
- Saisissez votre ID d'espace de travail, l'identifiant convivial pour les URL de votre espace de travail Bitbucket.
- Saisissez l'UUID de votre espace de travail. Copiez cette valeur à partir de l'exemple de charge utile figurant sur la page Paramètres OpenID Connect de votre référentiel.
Octopus Deploy
Saisissez votre URL de serveur Octopus, l'URL de base de votre serveur Octopus Deploy.
Terraform Cloud
Saisissez le Nom de votre organisation, le nom de l'organisation Terraform Cloud.
-
Renseignez les informations suivantes :
Paramètre Action Nom de la connexion Saisissez un nom unique et adapté pour une URL. Description de la connexion
Saisissez une description.
Sélectionnez la durée de vie du jeton
Saisissez un Montant et une Unité. Ils définissent la durée de validité du jeton d'accès Okta Privileged Access une fois émis.
Informations de configuration JWT
Sous l'onglet URL JWKS, saisissez l'URL où Okta Privileged Access récupère les clés publiques au moment de l'exécution.
Déclarations requises
Définissez les critères qui doivent être respectés dans le JWT de la charge de travail. Okta recommande d'inspecter votre JWT à l'aide d'un script de débogage ou de jwt.io.
-
Saisissez le Nom du champ source.
-
Sélectionnez le type d'opérateur :
-
Est égal à
-
Commence par
-
Existe
Si vous sélectionnez Existe, alors la saisie de la Valeur n'est pas requise.
-
-
Saisissez une Valeur.
-
Facultatif. Cliquez sur Ajouter une condition et répétez l'étape précédente.
-
-
Cliquez sur Créer une connexion à la charge de travail.
Créer une connexion de charge de travail IAM AWS
Les connections des charges de travail IAM AWS permettent à une charge de travail de s'authentifier à l'aide de son identité IAM AWS plutôt qu'à l'aide d'un JWT ou d'une clé API. La charge de travail n'a pas besoin de s'exécuter sur AWS, mais elle doit disposer d'identifiants AWS valides. La charge de travail signe une requête GetCallerIdentity STS AWS à l'aide de ses identifiants AWS, puis Okta Privileged Access vérifie la requête signée auprès de STS AWS. La connexion définit à quel compte AWS, et éventuellement à quelle identité AWS, la charge de travail doit appartenir.
-
Sur le tableau de bord Okta Privileged Access, accédez à .
-
Sélectionnez Créer une connexion à la charge de travail
-
Sélectionnez AWS.
-
Renseignez les informations suivantes :
Paramètre Action Nom de la connexion Saisissez un nom unique et adapté pour une URL. Description de la connexion
Saisissez une description.
Sélectionnez la durée de vie du jeton
Saisissez un Montant et une Unité. Ils définissent la durée de validité du jeton d'accès Okta Privileged Access une fois émis.
Compte AWS
Saisissez l'ID du compte AWS à 12 chiffres à partir duquel la charge de travail s'authentifie. Ce paramètre est obligatoire.
Récupérer à partir d'un ARN
Facultatif. Remplissez les paramètres d'identité de ce tableau à partir d'un nom de ressource Amazon (ARN) :
-
Sélectionnez Récupérer à partir d'un ARN.
-
Dans le champ ARN, collez l'ARN de l'identité utilisée par la charge de travail.
-
Sélectionnez Récupérer. Okta Privileged Access remplit les champs Type de ressource, Nom de la ressource, et Informations de session lorsqu'ils figurent dans l'ARN. Saisissez manuellement Région et ID de la ressource, car ils ne figurent pas dans l'ARN.
L'ARN est utilisé uniquement pour remplir les champs. Il n'est pas enregistré avec la connexion. Vous pouvez récupérer les formats d'ARN suivants :
-
arn:aws:sts::<account-id>:assumed-role/<role-name>/<session-name> -
arn:aws:iam::<account-id>:user/<user-name> -
arn:aws:sts::<account-id>:federated-user/<user-name>
Si vous saisissez un ARN non pris en charge, tel que l'ARN de l'utilisateur racine du compte AWS, un message d'erreur s'affiche et les champs conservent leurs valeurs actuelles.
Type de ressource
Facultatif. Sélectionnez le type d'identité AWS que la charge de travail doit utiliser : Rôle présumé, Utilisateur IAM, ou Utilisateur fédéré. Sélectionnez Non spécifié pour accepter tout type d'identité. Les paramètres qui ne s'appliquent pas au type que vous sélectionnez sont masqués et désactivés.
Nom de la ressource
Facultatif. Saisissez le nom du rôle IAM, de l'utilisateur IAM ou de l'utilisateur fédéré que la charge de travail doit utiliser.
Informations de session
Facultatif. Uniquement pour un rôle présumé, saisissez le nom de session que la charge de travail doit utiliser.
ID de ressource
Facultatif. Pour un rôle présumé ou un utilisateur IAM, saisissez l'ID AWS unique de l'identité. Par exemple, un ID de rôle présumé commence par
AROAet un ID d'utilisateur IAM commence parAIDA.Région
Facultatif. Saisissez la région AWS vers laquelle la charge de travail envoie sa requête signée, par exemple
us-west-2. -
-
Sélectionnez Créer une connexion à la charge de travail
Le compte AWS est le seul paramètre obligatoire. Si vous ne renseignez pas les paramètres d'identité facultatifs, n'importe quelle identité AWS de ce compte pourra correspondre à la connexion. Pour limiter la connexion à un rôle, un utilisateur ou une session spécifique, renseignez les paramètres facultatifs. Chaque paramètre que vous définissez doit correspondre exactement. Okta Privileged Access ne prend pas en charge d'autres opérateurs de comparaison pour les connexions IAM d'AWS.
Créer une connexion de charge de travail par clé API
Les connexions de charge de travail par clé API permettent aux charges de travail de s'authentifier à l'aide d'une clé API gérée plutôt que d'un JWT. Cette méthode est idéale pour les charges de travail ne relevant pas du cloud ou dans les cas où aucun fournisseur d'identité fédéré n'est disponible. Seuls les administrateurs de sécurité peuvent créer des connexions par clé API.
-
Sur le tableau de bord Okta Privileged Access, accédez à .
-
Cliquez sur Créer une connexion à la charge de travail.
-
Cliquez sur Clé API.
-
Renseignez les informations suivantes :
Paramètre Action Nom de la connexion Saisissez un nom unique et adapté pour une URL. Description de la connexion
Saisissez une description.
Sélectionnez la durée de vie du jeton
Saisissez un Montant et une Unité. Ils définissent la durée de validité du jeton d'accès Okta Privileged Access une fois émis.
-
Cliquez sur Créer une connexion à la charge de travail.
Contrairement aux connexions de charge de travail JWT, les connexions par clé API ne comportent pas de phase de brouillon. La connexion est créée directement avec le statut Actif et est immédiatement prête pour la génération de clés. Seuls les administrateurs de sécurité peuvent créer, modifier et supprimer des connexions par clé API.
Gérer une connexion à la charge de travail
Une fois que l'administrateur DevOps confirme que les tests sont terminés, l'administrateur de la sécurité promeut la connexion.
-
Sur le tableau de bord Okta Privileged Access, accédez à .
-
Sélectionnez une connexion à la charge de travail que vous souhaitez gérer.
-
Cliquez sur Actions, puis sélectionnez Modifier, Activer ou Désactiver.
-
Cliquez sur Activer la connexion à la charge de travail.
Lorsqu'une connexion à la charge de travail est promue en Actif, l'administrateur DevOps perd ses droits d'administration sur la connexion, et la connexion peut commencer immédiatement à émettre des jetons d'accès Okta Privileged Access valides. L'administrateur de la sécurité conserve la possibilité de basculer la connexion entre les statuts Actif et Inactif.