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, aud et sub) 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

  1. Sur le tableau de bord Okta Privileged Access, accédez à Administration DevOps > Connexions des charges de travail.

  2. Cliquez sur Créer une connexion à la charge de travail.

  3. Cliquez sur JWT générique.

  4. 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 keys comportant au moins une clé.

    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.

    1. Saisissez le Nom du champ source.

    2. 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.

    3. Saisissez une Valeur.

    4. Facultatif. Cliquez sur Ajouter une condition et répétez l'étape précédente.

  5. Cliquez sur Créer une connexion à la charge de travail.

Créer une connexion à la charge de travail spécifique au fournisseur

  1. Sur le tableau de bord Okta Privileged Access, accédez à Administration DevOps > Connexions des charges de travail.

  2. Cliquez sur Créer une connexion à la charge de travail.

  3. 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

    1. Saisissez votre ID d'organisation.
    2. Facultatif. Sélectionnez Périmètre pour l'ID de projet, puis saisissez l'ID.

    GitHub Actions

    Saisissez votre Propriétaire GitHub.

    GitLab

    1. Saisissez le nom de votre Domaine.
    2. Facultatif. Sélectionnez Périmètres pour le nom du groupe, puis saisissez le nom du groupe.
    3. Facultatif. Sélectionnez Périmètre pour le nom du projet, puis saisissez le nom du projet.
    4. Facultatif. Sélectionnez Périmètre pour l'ID du projet, puis saisissez l'ID du projet.

    Google Cloud Provider

    1. Saisissez votre ID d'app cliente.
    2. Facultatif. Sélectionnez Périmètre pour l'e-mail, puis saisissez l'e-mail.
    3. 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

    1. Saisissez votre ID d'espace de travail, l'identifiant convivial pour les URL de votre espace de travail Bitbucket.
    2. 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.

  4. 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.

    1. Saisissez le Nom du champ source.

    2. 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.

    3. Saisissez une Valeur.

    4. Facultatif. Cliquez sur Ajouter une condition et répétez l'étape précédente.

  5. 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.

  1. Sur le tableau de bord Okta Privileged Access, accédez à Administration DevOps > Connexions des charges de travail.

  2. Sélectionnez Créer une connexion à la charge de travail

  3. Sélectionnez AWS.

  4. 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) :

    1. Sélectionnez Récupérer à partir d'un ARN.

    2. Dans le champ ARN, collez l'ARN de l'identité utilisée par la charge de travail.

    3. 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 AROA et un ID d'utilisateur IAM commence par AIDA.

    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.

  5. Sélectionnez Créer une connexion à la charge de travail

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.

  1. Sur le tableau de bord Okta Privileged Access, accédez à Administration DevOps > Connexions des charges de travail.

  2. Cliquez sur Créer une connexion à la charge de travail.

  3. Cliquez sur Clé API.

  4. 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.

  5. Cliquez sur Créer une connexion à la charge de travail.

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.

  1. Sur le tableau de bord Okta Privileged Access, accédez à Administration DevOps > Connexions des charges de travail.

  2. Sélectionnez une connexion à la charge de travail que vous souhaitez gérer.

  3. Cliquez sur Actions, puis sélectionnez Modifier, Activer ou Désactiver.

  4. Cliquez sur Activer la connexion à la charge de travail.