Gestione degli utenti managing-users

Includi file di progetto.

Includi file JAR client, come adobe-usermanager-client.jar, nel percorso di classe del progetto Java.

Creare un client DirectoryManagerServices.

Crea un DirectoryManagerServiceClient utilizzando il relativo costruttore e passando un ServiceClientFactory oggetto contenente le proprietà di connessione.

Definisci le informazioni utente.

• Crea un UserImpl utilizzando il relativo costruttore.
• Imposta il nome del demain richiamando il UserImpl dell’oggetto setDomainName metodo . Passa un valore stringa che specifica il nome di dominio.
• Imposta il tipo di entità richiamando il UserImpl dell’oggetto setPrincipalType metodo . Passa un valore stringa che specifica il tipo di utente. Ad esempio, puoi specificare USER.
• Imposta il valore dell'identificatore utente richiamando il UserImpl dell’oggetto setUserid metodo . Passa un valore stringa che specifica il valore dell'identificatore utente. Ad esempio, puoi specificare wblue.
• Imposta il nome canonico richiamando il UserImpl dell’oggetto setCanonicalName metodo . Passa un valore stringa che specifica il nome canonico dell'utente. Ad esempio, puoi specificare wblue.
• Imposta il nome specificato richiamando il UserImpl dell’oggetto setGivenName metodo . Passa un valore di stringa che specifica il nome specificato dall'utente. Ad esempio, puoi specificare Wendy.
• Imposta il nome della famiglia richiamando il UserImpl dell’oggetto setFamilyName metodo . Passa un valore stringa che specifica il nome della famiglia dell'utente. Ad esempio, puoi specificare Blue.

Aggiungi l’utente ad AEM Forms.

Richiama il DirectoryManagerServiceClient dell’oggetto createLocalUser e passare i seguenti valori:

• La UserImpl oggetto che rappresenta il nuovo utente
• Valore stringa che rappresenta la password dell'utente

La createLocalUser restituisce un valore di stringa che specifica il valore dell'identificatore utente locale.

Verifica che l’utente sia stato aggiunto.

• Crea un PrincipalSearchFilter utilizzando il relativo costruttore.
• Imposta il valore dell'identificatore utente richiamando il PrincipalSearchFilter dell’oggetto setUserId metodo . Passa un valore stringa che rappresenta il valore dell'identificatore utente.
• Richiama il DirectoryManagerServiceClient dell’oggetto findPrincipals e passare il PrincipalSearchFilter oggetto. Questo metodo restituisce un java.util.List istanza, dove ogni elemento è un User oggetto. Itera attraverso il java.util.List istanza per individuare l'utente.

Includi file di progetto.

Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL per il riferimento al servizio: http://localhost:8080/soap/services/DirectoryManagerService?WSDL&lc_version=9.0.1.

Creare un client DirectoryManagerService.

• Crea un DirectoryManagerServiceClient utilizzando il relativo costruttore predefinito.

• Crea un DirectoryManagerServiceClient.Endpoint.Address utilizzando System.ServiceModel.EndpointAddress costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom). Non è necessario utilizzare il lc_version attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Assicurati di specificare ?blob=mtom.

• Crea un System.ServiceModel.BasicHttpBinding ottenendo il valore del DirectoryManagerServiceClient.Endpoint.Binding campo . Imposta il valore restituito su BasicHttpBinding.

• Imposta la System.ServiceModel.BasicHttpBinding dell’oggetto MessageEncoding campo a WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • Assegnare il nome utente del modulo di AEM al campo DirectoryManagerServiceClient.ClientCredentials.UserName.UserName.
  • Assegna il valore della password corrispondente al campo DirectoryManagerServiceClient.ClientCredentials.UserName.Password.
  • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Definisci le informazioni utente.

• Crea un UserImpl utilizzando il relativo costruttore.
• Imposta il nome della richiesta assegnando un valore stringa al UserImpl dell’oggetto domainName campo .
• Imposta il tipo principale assegnando un valore stringa al UserImpl dell’oggetto principalType campo . Ad esempio, puoi specificare USER.
• Imposta il valore dell'identificatore utente assegnando un valore stringa al UserImpl dell’oggetto userid campo .
• Imposta il valore del nome canonico assegnando un valore stringa al UserImpl dell’oggetto canonicalName campo .
• Imposta il valore del nome specificato assegnando un valore stringa al UserImpl dell’oggetto givenName campo .
• Imposta il valore del nome della famiglia assegnando un valore stringa al UserImpl dell’oggetto familyName campo .

Aggiungi l’utente ad AEM Forms.

Richiama il DirectoryManagerServiceClient dell’oggetto createLocalUser e passare i seguenti valori:

• La UserImpl oggetto che rappresenta il nuovo utente
• Valore stringa che rappresenta la password dell'utente

La createLocalUser restituisce un valore di stringa che specifica il valore dell'identificatore utente locale.

Verifica che l’utente sia stato aggiunto.

• Crea un PrincipalSearchFilter utilizzando il relativo costruttore.
• Imposta il valore dell'identificatore utente assegnando un valore stringa che rappresenta il valore dell'identificatore utente al PrincipalSearchFilter dell’oggetto userId campo .
• Richiama il DirectoryManagerServiceClient dell’oggetto findPrincipals e passare il PrincipalSearchFilter oggetto. Questo metodo restituisce un MyArrayOfUser oggetto raccolta, in cui ogni elemento è un User oggetto. Itera attraverso il MyArrayOfUser raccolta per individuare l'utente.

Includi file di progetto.

Includi file JAR client, come adobe-usermanager-client.jar, nel percorso di classe del progetto Java.

Creare un client DirectoryManagerService.

Crea un DirectoryManagerServiceClient utilizzando il relativo costruttore e passando un ServiceClientFactory oggetto contenente le proprietà di connessione.

Specifica l’utente da eliminare.

• Crea un PrincipalSearchFilter utilizzando il relativo costruttore.
• Imposta il valore dell'identificatore utente richiamando il PrincipalSearchFilter dell’oggetto setUserId metodo . Passa un valore stringa che rappresenta il valore dell'identificatore utente.
• Richiama il DirectoryManagerServiceClient dell’oggetto findPrincipals e passare il PrincipalSearchFilter oggetto. Questo metodo restituisce un java.util.List istanza, dove ogni elemento è un User oggetto. Itera attraverso il java.util.List istanza per individuare l'utente da eliminare.

Elimina l’utente da AEM Forms.

Richiama il DirectoryManagerServiceClient dell’oggetto deleteLocalUser e passare il valore del User dell’oggetto oid campo . Richiama il User dell’oggetto getOid metodo . Utilizza la User oggetto recuperato dal java.util.List istanza.

Includi file di progetto.

Includi file JAR client, come adobe-usermanager-client.jar, nel percorso di classe del progetto Java.

Creare un client DirectoryManagerService.

• Crea un DirectoryManagerServiceClient utilizzando il relativo costruttore predefinito.

• Crea un DirectoryManagerServiceClient.Endpoint.Address utilizzando System.ServiceModel.EndpointAddress costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom). Non è necessario utilizzare il lc_version attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Assicurati di specificare blob=mtom.

• Crea un System.ServiceModel.BasicHttpBinding ottenendo il valore del DirectoryManagerServiceClient.Endpoint.Binding campo . Imposta il valore restituito su BasicHttpBinding.

• Imposta la System.ServiceModel.BasicHttpBinding dell’oggetto MessageEncoding campo a WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • Assegnare il nome utente del modulo di AEM al campo DirectoryManagerServiceClient.ClientCredentials.UserName.UserName.
  • Assegna il valore della password corrispondente al campo DirectoryManagerServiceClient.ClientCredentials.UserName.Password.
  • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Specifica l’utente da eliminare.

• Crea un PrincipalSearchFilter utilizzando il relativo costruttore.
• Imposta il valore dell'identificatore utente assegnando un valore stringa al PrincipalSearchFilter dell’oggetto userId campo .
• Richiama il DirectoryManagerServiceClient dell’oggetto findPrincipals e passare il PrincipalSearchFilter oggetto. Questo metodo restituisce un MyArrayOfUser oggetto raccolta, in cui ogni elemento è un User oggetto. Itera attraverso il MyArrayOfUser raccolta per individuare l'utente. La User oggetto recuperato dal MyArrayOfUser l'oggetto collection viene utilizzato per eliminare l'utente.

Elimina l’utente da AEM Forms.

Elimina l'utente passando il User dell’oggetto oid valore del campo nel DirectoryManagerServiceClient dell’oggetto deleteLocalUser metodo .

Includi file di progetto.

Includi file JAR client, come adobe-usermanager-client.jar, nel percorso di classe del progetto Java.

Creare un client DirectoryManagerService.

Crea un DirectoryManagerServiceClient utilizzando il relativo costruttore e passando un ServiceClientFactory oggetto contenente le proprietà di connessione.

Determina se il gruppo esiste.

• Crea un PrincipalSearchFilter utilizzando il relativo costruttore.
• Imposta il tipo di entità richiamando il PrincipalSearchFilter dell’oggetto setPrincipalType oggetto. Passa il valore com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP.
• Imposta il dominio richiamando il PrincipalSearchFilter dell’oggetto setSpecificDomainName oggetto. Passa un valore stringa che specifica il nome di dominio.
• Per trovare un gruppo, invoca il DirectoryManagerServiceClient dell’oggetto findPrincipals (un'entità principale può essere un gruppo). Passa la PrincipalSearchFilter oggetto che specifica il tipo principale e il nome di dominio. Questo metodo restituisce un java.util.List istanza in cui ogni elemento è un Group istanza. Ogni istanza di gruppo è conforme al filtro specificato utilizzando il PrincipalSearchFilter oggetto.
• Itera attraverso il java.util.List istanza. Per ogni elemento, recupera il nome del gruppo. Assicurati che il nome del gruppo non sia uguale al nuovo nome del gruppo.

Crea il gruppo.

• Se il gruppo non esiste, richiama il Group dell’oggetto setCommonName e passare un valore stringa che specifica il nome del gruppo.
• Richiama il Group dell’oggetto setDescription e passare un valore stringa che specifica la descrizione del gruppo.
• Richiama il Group dell’oggetto setDomainName e passare un valore stringa che specifica il nome di dominio.
• Richiama il DirectoryManagerServiceClient dell’oggetto createLocalGroup e passare il Group istanza.

La createLocalUser restituisce un valore di stringa che specifica il valore dell'identificatore utente locale.

Esegui un'azione con il gruppo.

• Crea un PrincipalSearchFilter utilizzando il relativo costruttore.
• Imposta il valore dell'identificatore utente richiamando il PrincipalSearchFilter dell’oggetto setUserId metodo . Passa un valore stringa che rappresenta il valore dell'identificatore utente.
• Richiama il DirectoryManagerServiceClient dell’oggetto findPrincipals e passare il PrincipalSearchFilter oggetto. Questo metodo restituisce un java.util.List istanza, dove ogni elemento è un User oggetto. Itera attraverso il java.util.List istanza per individuare l'utente.
• Aggiungi un utente al gruppo richiamando il DirectoryManagerServiceClient dell’oggetto addPrincipalToLocalGroup metodo . Passa il valore restituito di User dell’oggetto getOid metodo . Passa il valore restituito di Group degli oggetti getOid (utilizzare Group che rappresenta il nuovo gruppo).

Includi file di progetto.

Includi file JAR client, come adobe-usermanager-client.jar, nel percorso di classe del progetto Java. Per informazioni sulla posizione di questi file, vedi Inclusione dei file libreria Java di AEM Forms.

Creare un client DirectoryManagerService.

Crea un DirectoryManagerServiceClient utilizzando il relativo costruttore e passando un ServiceClientFactory oggetto contenente le proprietà di connessione. Per informazioni, consulta Impostazione delle proprietà di connessione.

Richiama le operazioni utente o di gruppo appropriate.

Per trovare un utente o un gruppo, richiamare una delle DirectoryManagerServiceClient metodi dell'oggetto per la ricerca di entità principali (poiché un'entità può essere un utente o un gruppo). Nell’esempio seguente, la findPrincipals viene chiamato utilizzando un filtro di ricerca (a PrincipalSearchFilter oggetto).

Poiché in questo caso il valore restituito è un java.util.List contenente Principal oggetti, eseguire iterazioni nel risultato e creare il cast Principal oggetti User o Group oggetti.

Utilizzo del risultato User o Group (che ereditano entrambi dal Principal , recupera le informazioni necessarie nei flussi di lavoro. Ad esempio, i valori del nome di dominio e del nome canonico, in combinazione, identificano in modo univoco un'entità principale. Questi vengono recuperati richiamando il Principal dell’oggetto getDomainName e getCanonicalName metodi, rispettivamente.

Per eliminare un utente locale, richiama il DirectoryManagerServiceClient dell’oggetto deleteLocalUser e passa l'identificatore dell'utente.

Per eliminare un gruppo locale, richiamare DirectoryManagerServiceClient dell’oggetto deleteLocalGroup e passare l'identificatore del gruppo.

Includi file di progetto.

• Creare un assembly client Microsoft .NET che utilizzi la WSDL di Directory Manager. (Vedi Richiamo di AEM Forms con codifica Base64.)
• Fare riferimento all'assembly client Microsoft .NET. (Vedi Creazione di un assembly client .NET che utilizza la codifica Base64.)

Creare un client DirectoryManagerService.

Crea un DirectoryManagerServiceService utilizzando il costruttore della classe proxy.

Richiama le operazioni utente o di gruppo appropriate.

Per trovare un utente o un gruppo, richiamare una delle DirectoryManagerServiceService metodi dell'oggetto per la ricerca di entità principali (poiché un'entità può essere un utente o un gruppo). Nell’esempio seguente, la findPrincipalsWithFilter viene chiamato utilizzando un filtro di ricerca (a PrincipalSearchFilter oggetto). Quando si utilizza un PrincipalSearchFilter oggetto , le entità locali vengono restituite solo se la isLocal è impostata su true. Questo comportamento è diverso da quello che si verificherebbe con l’API Java.

Poiché in questo caso il valore restituito è un valore object[] contenente Principal oggetti, eseguire iterazioni nel risultato e creare il cast Principal oggetti User o Group oggetti.

Utilizzo del risultato User o Group (che ereditano entrambi dal Principal , recupera le informazioni necessarie nei flussi di lavoro. Ad esempio, i valori del nome di dominio e del nome canonico, in combinazione, identificano in modo univoco un'entità principale. Questi vengono recuperati richiamando il Principal dell’oggetto domainName e canonicalName rispettivamente.

Per eliminare un utente locale, richiama il DirectoryManagerServiceService dell’oggetto deleteLocalUser e passa l'identificatore dell'utente.

Per eliminare un gruppo locale, richiamare DirectoryManagerServiceService dell’oggetto deleteLocalGroup e passare l'identificatore del gruppo.

Includi file di progetto.

Includi file JAR client, come adobe-usermanager-client.jar, nel percorso di classe del progetto Java.

Creare un client AuthorizationManagerService.

Crea un AuthorizationManagerServiceClient utilizzando il relativo costruttore e passando un ServiceClientFactory oggetto contenente le proprietà di connessione.

Richiama le operazioni di ruolo o autorizzazione appropriate.

Per assegnare un ruolo a un'entità, richiamare l' AuthorizationManagerServiceClient dell’oggetto assignRole e passare i seguenti valori:

• A java.lang.String oggetto contenente l'identificatore del ruolo
• Matrice di java.lang.String oggetti contenenti gli identificatori principali.

Per rimuovere un ruolo da un'entità, richiamare l' AuthorizationManagerServiceClient dell’oggetto unassignRole e passare i seguenti valori:

• A java.lang.String oggetto contenente l'identificatore del ruolo.
• Matrice di java.lang.String oggetti contenenti gli identificatori principali.

Includi file di progetto.

Creare un progetto Microsoft .NET che utilizza MTOM. Assicurati di utilizzare la seguente definizione WSDL: http://localhost:8080/soap/services/AuthorizationManagerService?WSDL&lc_version=9.0.1.

Creare un client AuthorizationManagerService.

• Crea un AuthorizationManagerServiceClient utilizzando il relativo costruttore predefinito.

• Crea un AuthorizationManagerServiceClient.Endpoint.Address utilizzando System.ServiceModel.EndpointAddress costruttore. Passa un valore stringa che specifica il WSDL al servizio AEM Forms (ad esempio, http://localhost:8080/soap/services/AuthorizationManagerService?blob=mtom.) Non è necessario utilizzare il lc_version attributo. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.

• Crea un System.ServiceModel.BasicHttpBinding ottenendo il valore del AuthorizationManagerServiceClient.Endpoint.Binding campo . Imposta il valore restituito su BasicHttpBinding.

• Imposta la System.ServiceModel.BasicHttpBinding dell’oggetto MessageEncoding campo a WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

• Abilita l’autenticazione HTTP di base eseguendo le seguenti attività:

  • Assegnare il nome utente del modulo di AEM al campo AuthorizationManagerServiceClient.ClientCredentials.UserName.UserName.
  • Assegna il valore della password corrispondente al campo AuthorizationManagerServiceClient.ClientCredentials.UserName.Password.
  • Assegna il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assegna il valore costante BasicHttpSecurityMode.TransportCredentialOnly al campo BasicHttpBindingSecurity.Security.Mode.

Richiama le operazioni di ruolo o autorizzazione appropriate.

Per assegnare un ruolo a un'entità, richiamare l' AuthorizationManagerServiceClient dell’oggetto assignRole e passare i seguenti valori:

• A string oggetto contenente l'identificatore del ruolo
• A MyArrayOf_xsd_string oggetto contenente gli identificatori principali.

Per rimuovere un ruolo da un'entità, richiamare l' AuthorizationManagerServiceService dell’oggetto unassignRole e passare i seguenti valori:

• A string oggetto contenente l'identificatore del ruolo.
• Matrice di string oggetti contenenti gli identificatori principali.

Includi file di progetto.

Includi file JAR client, come adobe-usermanager-client.jar, nel percorso di classe del progetto Java.

Creare un client AuthenticationManagerServices.

Crea un AuthenticationManagerServiceClient utilizzando il relativo costruttore e passando un ServiceClientFactory oggetto contenente le proprietà di connessione.

Richiama l'operazione di autenticazione.

Richiama il AuthenticationManagerServiceClient dell’oggetto authenticate e passare i seguenti valori:

• A java.lang.String oggetto contenente il nome dell'utente.
• Matrice di byte (a byte[] ) contenente la password dell'utente. È possibile ottenere byte[] richiamando l'oggetto java.lang.String dell’oggetto getBytes metodo .

Il metodo authenticate restituisce un AuthResult oggetto , che contiene informazioni sull'utente autenticato.

Recupera il contesto di autenticazione.

Richiama il ServiceClientFactory dell’oggetto getContext che restituirà un Context oggetto.

Quindi invoca il Context dell’oggetto initPrincipal e passare il AuthResult.

Includi file di progetto.

• Creare un assembly client Microsoft .NET che utilizzi la WSDL di Authentication Manager. (Vedi Richiamo di AEM Forms con codifica Base64.)
• Fare riferimento all'assembly client Microsoft .NET. (Vedere "Riferimento all'assembly client .NET" in Richiamo di AEM Forms con codifica Base64.)

Crea un client AuthenticationManagerService.

Crea un AuthenticationManagerServiceService utilizzando il costruttore della classe proxy.

Richiama l'operazione di autenticazione.

Richiama il AuthenticationManagerServiceClient dell’oggetto authenticate e passare i seguenti valori:

• A string oggetto contenente il nome dell'utente
• Matrice di byte (a byte[] ) contenente la password dell'utente. È possibile ottenere byte[] conversione di un oggetto string oggetto contenente la password di un byte[] utilizzando la logica mostrata nell’esempio seguente.
• Il valore restituito sarà un AuthResult oggetto , che può essere utilizzato per recuperare informazioni sull'utente. Nell’esempio seguente, le informazioni dell’utente vengono recuperate ottenendo prima il AuthResult dell’oggetto authenticatedUser e successivamente ottenere il risultato User dell’oggetto canonicalName e domainName campi.

Includi file di progetto.

Includi file JAR client, come adobe-usermanager-client.jar e adobe-usermanager-util-client.jar, nel percorso di classe del progetto Java.

Creare un client UserManagerUtilServiceClient.

Crea un UserManagerUtilServiceClient utilizzando il relativo costruttore e passando un ServiceClientFactory oggetto contenente le proprietà di connessione.

Specifica il dominio enterprise.

• Richiama il UserManagerUtilServiceClient dell’oggetto scheduleSynchronization per avviare l'operazione di sincronizzazione utente.
• Crea un java.util.Set tramite un HashSet costruttore. Assicurati di specificare String come tipo di dati. Questo Java.util.Set instance memorizza i nomi di dominio a cui si applica l'operazione di sincronizzazione.
• Per ogni nome di dominio da aggiungere, invoca la java.util.Set metodo add dell'oggetto e passare il nome di dominio.

Richiama l'operazione di sincronizzazione.

Richiama il ServiceClientFactory dell’oggetto getContext che restituirà un Context oggetto.

Quindi invoca il Context dell’oggetto initPrincipal e passare il AuthResult.