Connect WorkDocs mit IAM-Benutzeranmeldedaten her und fragen Sie nach Benutzern ab

Der folgende Code zeigt, wie Sie die API-Anmeldeinformationen eines IAM-Benutzers für API-Aufrufe verwenden. In diesem Fall gehören der API-Benutzer und die WorkDocs Site zu demselben AWS Konto.

Anmerkung

Um die Sicherheit zu erhöhen, sollten Sie nach Möglichkeit Verbundbenutzer anstelle von IAM-Benutzern erstellen.

Stellen Sie sicher, dass dem IAM-Benutzer über eine entsprechende WorkDocs IAM-Richtlinie API-Zugriff gewährt wurde.

Das Codebeispiel verwendet die DescribeUsersAPI, um nach Benutzern zu suchen und Metadaten für Benutzer abzurufen. Benutzermetadaten enthalten Details wie Vorname, Nachname, Benutzer-ID und Stammordner-ID. Die Stammordner-ID ist besonders hilfreich, wenn Sie im Namen des Benutzers Vorgänge zum Hoch- oder Herunterladen von Inhalten ausführen möchten.

Der Code erfordert, dass Sie eine WorkDocs Organisations-ID erhalten.

Gehen Sie wie folgt vor, um eine WorkDocs Organisations-ID von der AWS Konsole abzurufen:

So rufen Sie eine Organisations-ID ab

1. Wählen Sie im Navigationsbereich der AWS Directory Service -Konsole Directories aus.

2. Notieren Sie sich den Verzeichnis-ID-Wert, der Ihrer WorkDocs Site entspricht. Das ist die Organisations-ID für die Site.

Das folgende Beispiel zeigt, wie Sie IAM-Anmeldeinformationen für API-Aufrufe verwenden.

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());
    }
  }
}