Gérer d'une main-d'œuvre privée (OIDC IdP) - Amazon SageMaker

Gérer d'une main-d'œuvre privée (OIDC IdP)

Une fois que vous avez créé une main-d'œuvre privée en utilisant votre fournisseur d'identité (IdP) OpenID Connect (OIDC), vous pouvez gérer vos employés en utilisant votre IdP. Vous pouvez par exemple ajouter, supprimer et regrouper des employés directement via votre IdP.

Pour ajouter des employés à une tâche de labélisation Amazon SageMaker Ground Truth (Ground Truth) ou à une tâche de révision humaine Amazon Augmented AI (Amazon A2I), vous créez des équipes de travail à l'aide de 1 à 10 groupes IdP et vous affectez cette équipe de travail à la tâche ou au travail. Vous affectez une équipe de travail à un travail ou à une tâche en spécifiant cette équipe de travail lorsque vous créez un travail de labélisation (Ground Truth) ou un flux de travail de révision humaine (Amazon A2I).

Vous ne pouvez affecter qu'une seule équipe à chaque tâche de labélisation ou à chaque flux de travail de révision humaine. Vous pouvez utiliser la même équipe pour créer plusieurs tâches de labélisation ou de révision humaine. Vous pouvez également créer plusieurs équipes de travail pour travailler sur différentes tâches de labélisation ou de révision humaine.

Conditions préalables

Pour créer et gérer des équipes de travail privées à l'aide de vos groupes d'IdP OIDC, vous devez d'abord créer une main-d'œuvre à l'aide de l'opération de l'API SageMaker CreateWorkforce. Pour en savoir plus, consultez Créer une main-d'œuvre privée (OIDC IdP).

Ajout d'équipes de travail

Vous pouvez utiliser la console SageMaker pour créer une équipe de travail privée à l'aide de votre main d'œuvre OIDC IdP sur la page Labeling workforces (Main d'œuvre de labélisation) sous Ground Truth. Si vous créez une tâche de labélisation Ground Truth, vous pouvez également créer une équipe de travail privée lors de la création d'une tâche de labélisation.

Note

Vous créez et gérez les équipes de travail pour Amazon A2I dans la zone Ground Truth de la console SageMaker.

Vous pouvez également utiliser l'API SageMaker et les SDK associés spécifiques à la langue pour créer une équipe de travail privée.

Utilisez les procédures suivantes pour apprendre à créer une équipe de travail privée à l'aide de la console et de l'API SageMaker.

Pour créer une équipe de travail privée sur la page Main d'œuvre de labélisation (console)

  1. Accédez à la zone Ground Truth de la console SageMaker :https://console.aws.amazon.com/sagemaker/groundtruth.

  2. Sélectionnez Labeling workforces (Main d'œuvre de labélisation).

  3. Cliquez sur Private (Privé).

  4. Dans la section Private teams (Équipes privées), cliquez sur Create private team (Créer une équipe privée).

  5. Dans la section Team details (Détails de l'équipe), entrez un Team name (Nom de l'équipe).

  6. Dans la section Add workers (Ajout d'employés), saisissez le nom d'un seul groupe d'utilisateurs. Tous les employés associés à ce groupe dans votre IdP sont ajoutés à cette équipe de travail.

  7. Pour ajouter plusieurs groupes d'utilisateurs, cliquez sur Add new user group (Ajouter un nouveau groupe d'utilisateurs) et saisissez les noms des groupes d'utilisateurs que vous souhaitez ajouter à cette équipe de travail. Entrez un groupe d'utilisateurs par ligne.

  8. (Facultatif) Pour les tâches de labélisation Ground Truth, si vous fournissez un e-mail pour les employés dans votre JWT, Ground Truth notifie les employés lorsqu'une nouvelle tâche de labélisation est disponible si vous sélectionnez une rubrique SNS.

  9. Cliquez sur Create private team (Créer une équipe privée).

Pour créer une équipe de travail privée lors de la création d'une tâche de labélisation Ground Truth (console)

  1. Accédez à la zone Ground Truth de la console SageMaker :https://console.aws.amazon.com/sagemaker/groundtruth.

  2. Sélectionnez Labeling jobs (Tâches de labélisation).

  3. Utilisez les instructions fournies dans Création d'une tâche d'étiquetage (Console) pour créer une tâche de labélisation. Arrêtez-vous lorsque vous arrivez à la section Workers (Employés) sur la deuxième page.

  4. Sélectionnez Private (Privé) pour le type de votre employé.

  5. Saisissez un Team name (Nom d'équipe).

  6. Dans la section Add workers (Ajout d'employés), saisissez le nom d'un seul groupe d'utilisateurs sous User groups (Groupes d'utilisateurs). Tous les employés associés à ce groupe dans votre IdP sont ajoutés à cette équipe de travail.

    Important

    Les noms de groupe que vous spécifiez pour User groups (Groupes d'utilisateurs) doit correspondre aux noms de groupe spécifiés dans votre IdP OIDC.

  7. Pour ajouter plusieurs groupes d'utilisateurs, sélectionnez Add new user group (Ajouter un nouveau groupe d'utilisateurs) et saisissez les noms des groupes d'utilisateurs que vous souhaitez ajouter à cette équipe de travail. Entrez un groupe d'utilisateurs par ligne.

  8. Effectuez toutes les étapes restantes pour créer votre tâche de labélisation.

L'équipe privée que vous créez est utilisée pour cette tâche de labélisation et est répertoriée dans la section Labeling workforces (Main-d'œuvre de labélisation) de la console SageMaker.

Pour créer une équipe de travail privée avec l'API SageMaker

Vous pouvez créer une équipe de travail privée à l'aide de l'opération de l'API SageMaker CreateWorkteam.

Lorsque vous utilisez cette opération, dressez la liste de tous les groupes d'utilisateurs que vous souhaitez inclure dans l'équipe de travail dans le paramètre OidcMemberDefinition de Groups.

Important

Les noms de groupe que vous spécifiez pour Groups doit correspondre aux noms de groupe spécifiés dans votre IdP OIDC.

Par exemple, si vos noms de groupes d'utilisateurs sont group1, group2 et group3 dans votre IdP OIDC, configurez OidcMemberDefinition comme suit :

"OidcMemberDefinition": { "Groups": ["group1", "group2", "group3"] }

En outre, vous devez donner un nom à l'équipe de travail à l'aide du paramètre WorkteamName.

Ajouter ou supprimer des groupes IdP des équipes de travail

Après avoir créé une équipe de travail, vous pouvez utiliser l'API SageMaker pour gérer cette équipe de travail. Utilisez l'opération UpdateWorkteam pour mettre à jour les groupes d'utilisateurs IdP inclus dans cette équipe de travail.

  • Utilisez le paramètre WorkteamName pour identifier l'équipe de travail que vous souhaitez mettre à jour.

  • Lorsque vous utilisez cette opération, dressez la liste de tous les groupes d'utilisateurs que vous souhaitez inclure dans l'équipe de travail dans le paramètre OidcMemberDefinition de Groups. Si un groupe d'utilisateurs est associé à une équipe de travail et que vous ne l'incluez pas dans cette liste, ce groupe d'utilisateurs n'est plus associé à cette équipe de travail.

Suppression d'une équipe de travail

Vous pouvez supprimer une équipe de travail à l'aide de la console SageMaker et de l'API SageMaker.

Pour supprimer une équipe de travail privée dans la console SageMaker

  1. Accédez à la zone Ground Truth de la console SageMaker :https://console.aws.amazon.com/sagemaker/groundtruth.

  2. Sélectionnez Labeling workforces (Main d'œuvre de labélisation).

  3. Sélectionnez Private (Privé).

  4. Dans la section Private teams (Équipes privées) sélectionnez l'équipe dans laquelle vous souhaitez supprimer des travailleurs.

  5. Sélectionnez Delete (Supprimer).

Pour supprimer une équipe de travail privée (API)

Vous pouvez supprimer une équipe de travail privée à l'aide de l'opération de l'API SageMaker DeleteWorkteam.

Gérer les employés individuels

Lorsque vous créez une main-d'œuvre à l'aide de votre propre IdP OIDC, vous ne pouvez pas utiliser Ground Truth ou Amazon A2I pour gérer des employés individuels.

  • Pour ajouter un employé à une équipe de travail, ajoutez-le à un groupe associé à cette équipe de travail.

  • Pour supprimer un employé d'une équipe de travail, supprimez le de tous les groupes d'utilisateurs associés à cette équipe de travail.

Mettre à jour, supprimer et décrire votre main-d'œuvre

Vous pouvez mettre à jour, supprimer et décrire votre main-d'œuvre IdP OIDC à l'aide de l'API SageMaker. La liste suivante contient les opérations d'API que vous pouvez utiliser pour gérer votre main-d'œuvre. Pour plus d'informations, y compris la façon de localiser le nom de votre main-d'œuvre, veuillez consulter Gérer la main-d'œuvre privée à l'aide de l'API Amazon SageMaker.

  • UpdateWorkforce – Vous pouvez mettre à jour une main-d'œuvre créée à l'aide de votre propre OIDC IdP pour spécifier un point de terminaison d'autorisation, un point de terminaison de jeton ou un diffuseur différent. Vous pouvez mettre à jour n'importe quel paramètre trouvé dans OidcConfig à l'aide de cette opération.

    Vous ne pouvez mettre à jour votre configuration OIDC IdP que lorsqu'il n'y a pas d'équipes de travail associées à votre main-d'œuvre. Pour savoir comment supprimer des équipes de travail, veuillez consulter Suppression d'une équipe de travail.

  • DeleteWorkforce – Utilisez cette opération pour supprimer votre main-d'œuvre privée. Si vous avez des équipes de travail associées à votre main-d'œuvre, vous devez supprimer ces équipes avant de supprimer votre main-d'œuvre. Pour de plus amples informations, veuillez consulter Suppression d'une équipe de travail.

  • DescribeWorkforce – Utilisez cette opération pour répertorier les informations relatives à la main-d'œuvre privée, notamment le nom de la main-d'œuvre, l'Amazon Resource Name (ARN) et, le cas échéant, les plages d'adresses IP autorisées (CIDR).