Connectez-vous à l' WorkDocs aide des informations d'identification utilisateur IAM et interrogez les utilisateurs

Le code suivant montre comment utiliser les informations d'identification d'API d'un utilisateur IAM pour effectuer des appels d'API. Dans ce cas, l'utilisateur de l'API et le WorkDocs site appartiennent au même AWS compte.

Note

Pour plus de sécurité, créez des utilisateurs fédérés plutôt que des utilisateurs IAM dans la mesure du possible.

Assurez-vous que l'utilisateur IAM a obtenu l'accès à l' WorkDocs API par le biais d'une politique IAM appropriée.

L'exemple de code utilise l'DescribeUsersAPI pour rechercher des utilisateurs et obtenir des métadonnées pour les utilisateurs. Les métadonnées utilisateur fournissent des informations telles que le prénom, le nom de famille, l'ID utilisateur et l'ID du dossier racine. L'ID du dossier racine est particulièrement utile si vous souhaitez effectuer des opérations de chargement ou de téléchargement de contenu pour le compte de l'utilisateur.

Le code exige que vous obteniez un identifiant d' WorkDocs organisation.

Procédez comme suit pour obtenir un identifiant d' WorkDocs organisation à partir de la AWS console :

Pour obtenir un ID d'organisation

1. Dans le panneau de navigation de la console AWS Directory Service, choisissez Annuaires.

2. Notez la valeur de l'ID de répertoire qui correspond à votre WorkDocs site. Il s'agit de l'identifiant d'organisation du site.

L'exemple suivant montre comment utiliser les informations d'identification IAM pour effectuer des appels d'API.

import java.util.ArrayList;
import java.util.List;

import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.AWSStaticCredentialsProvider;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.workdocs.AmazonWorkDocs;
import com.amazonaws.services.workdocs.AmazonWorkDocsClient;
import com.amazonaws.services.workdocs.model.DescribeUsersRequest;
import com.amazonaws.services.workdocs.model.DescribeUsersResult;
import com.amazonaws.services.workdocs.model.User;

public class GetUserDemo {

  public static void main(String[] args) throws Exception {
    AWSCredentials longTermCredentials =
        new BasicAWSCredentials("accessKey", "secretKey");
    AWSStaticCredentialsProvider staticCredentialProvider =
        new AWSStaticCredentialsProvider(longTermCredentials);

    AmazonWorkDocs workDocs =
        AmazonWorkDocsClient.builder().withCredentials(staticCredentialProvider)
            .withRegion(Regions.US_WEST_2).build();

    List<User> wdUsers = new ArrayList<>();
    DescribeUsersRequest request = new DescribeUsersRequest();
	
    // The OrganizationId used here is an example and it should be replaced 
	   // with the OrganizationId of your WorkDocs site.
    request.setOrganizationId("d-123456789c");
    request.setQuery("joe");
	
    String marker = null;
    do {
      request.setMarker(marker);
      DescribeUsersResult result = workDocs.describeUsers(request);
      wdUsers.addAll(result.getUsers());
      marker = result.getMarker();
    } while (marker != null);
	
    System.out.println("List of users matching the query string: joe ");
    
	for (User wdUser : wdUsers) {
      System.out.printf("Firstname:%s | Lastname:%s | Email:%s | root-folder-id:%s\n",
          wdUser.getGivenName(), wdUser.getSurname(), wdUser.getEmailAddress(),
          wdUser.getRootFolderId());
    }
  }
}