Conéctese WorkDocs con las credenciales de usuario de IAM y consulte a los usuarios

El siguiente código muestra cómo utilizar las credenciales de API de un usuario de IAM para realizar llamadas a la API. En este caso, el usuario de la API y el WorkDocs sitio pertenecen a la misma AWS cuenta.

nota

Para mayor seguridad, cree usuarios federados en lugar de usuarios de IAM siempre que sea posible.

Asegúrese de que se haya concedido al usuario de IAM el acceso a la WorkDocs API mediante una política de IAM adecuada.

El ejemplo de código utiliza la DescribeUsersAPI para buscar usuarios y obtener metadatos para los usuarios. Los metadatos de los usuarios proporcionan detalles como el nombre, los apellidos, el ID de usuario y el ID de carpeta raíz. El ID de carpeta raíz es especialmente útil si desea realizar operaciones de carga o descarga de contenido en nombre del usuario.

El código requiere que obtengas un identificador de WorkDocs organización.

Sigue estos pasos para obtener un identificador de WorkDocs organización desde la AWS consola:

Para obtener un ID de organización

1. En el panel de navegación de la consola de AWS Directory Service, elija Directorios.

2. Anote el valor del ID de directorio que corresponde a su WorkDocs sitio. Es el ID de organización del sitio.

El siguiente ejemplo muestra cómo utilizar las credenciales de IAM para realizar llamadas a la 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());
    }
  }
}