Gestione degli utenti managing-users

Includi file di progetto.

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

Creare un client DirectoryManagerServices.

Creare un oggetto DirectoryManagerServiceClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory che contiene proprietà di connessione.

Definire le informazioni utente.

• Creare un oggetto UserImpl utilizzando il relativo costruttore.
• Impostare il nome del dominio richiamando il metodo setDomainName dell'oggetto UserImpl. Passa un valore stringa che specifica il nome di dominio.
• Impostare il tipo di entità richiamando il metodo setPrincipalType dell'oggetto UserImpl. Passa un valore stringa che specifica il tipo di utente. Ad esempio, è possibile specificare USER.
• Impostare il valore dell'identificatore utente richiamando il metodo setUserid dell'oggetto UserImpl. Passa un valore stringa che specifica il valore dell'identificatore utente. Ad esempio, è possibile specificare wblue.
• Impostare il nome canonico richiamando il metodo setCanonicalName dell'oggetto UserImpl. Passa un valore stringa che specifica il nome canonico dell'utente. Ad esempio, è possibile specificare wblue.
• Impostare il nome specificato richiamando il metodo setGivenName dell'oggetto UserImpl. Passa un valore stringa che specifica il nome dell'utente. Ad esempio, è possibile specificare Wendy.
• Impostare il cognome richiamando il metodo setFamilyName dell'oggetto UserImpl. Passa un valore stringa che specifica il cognome dell'utente. Ad esempio, è possibile specificare Blue.

Aggiungi l’utente ad AEM Forms.

Richiama il metodo createLocalUser dell'oggetto DirectoryManagerServiceClient e passa i seguenti valori:

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

Il metodo createLocalUser restituisce un valore stringa che specifica il valore dell'identificatore utente locale.

Verifica che l’utente sia stato aggiunto.

• Creare un oggetto PrincipalSearchFilter utilizzando il relativo costruttore.
• Impostare il valore dell'identificatore utente richiamando il metodo setUserId dell'oggetto PrincipalSearchFilter. Passa un valore stringa che rappresenta il valore dell'identificatore utente.
• Richiama il metodo findPrincipals dell'oggetto DirectoryManagerServiceClient e passa l'oggetto PrincipalSearchFilter. Questo metodo restituisce un'istanza java.util.List, in cui ogni elemento è un oggetto User. Scorrere l'istanza java.util.List per individuare l'utente.

Includi file di progetto.

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

Creare un client DirectoryManagerService.

• Creare un oggetto DirectoryManagerServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto DirectoryManagerServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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 l'attributo lc_version. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Assicurarsi di specificare ?blob=mtom.

• Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DirectoryManagerServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito in BasicHttpBinding.

• Impostare il campo MessageEncoding dell'oggetto System.ServiceModel.BasicHttpBinding su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

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

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

Definire le informazioni utente.

• Creare un oggetto UserImpl utilizzando il relativo costruttore.
• Impostare il nome del dominio assegnando un valore stringa al campo domainName dell'oggetto UserImpl.
• Impostare il tipo di entità assegnando un valore stringa al campo principalType dell'oggetto UserImpl. Ad esempio, è possibile specificare USER.
• Impostare il valore dell'identificatore utente assegnando un valore stringa al campo userid dell'oggetto UserImpl.
• Impostare il valore del nome canonico assegnando un valore stringa al campo canonicalName dell'oggetto UserImpl.
• Impostare il valore del nome specificato assegnando un valore stringa al campo givenName dell'oggetto UserImpl.
• Impostare il valore del family name assegnando un valore stringa al campo familyName dell'oggetto UserImpl.

Aggiungi l’utente ad AEM Forms.

Richiama il metodo createLocalUser dell'oggetto DirectoryManagerServiceClient e passa i seguenti valori:

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

Il metodo createLocalUser restituisce un valore stringa che specifica il valore dell'identificatore utente locale.

Verifica che l’utente sia stato aggiunto.

• Creare un oggetto PrincipalSearchFilter utilizzando il relativo costruttore.
• Impostare il valore dell'identificatore utente assegnando un valore stringa che rappresenta il valore dell'identificatore utente al campo userId dell'oggetto PrincipalSearchFilter.
• Richiama il metodo findPrincipals dell'oggetto DirectoryManagerServiceClient e passa l'oggetto PrincipalSearchFilter. Questo metodo restituisce un insieme MyArrayOfUser, dove ogni elemento è un oggetto User. Scorrere la raccolta MyArrayOfUser per individuare l'utente.

Includi file di progetto.

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

Creare un client DirectoryManagerService.

Creare un oggetto DirectoryManagerServiceClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory che contiene proprietà di connessione.

Specificare l'utente da eliminare.

• Creare un oggetto PrincipalSearchFilter utilizzando il relativo costruttore.
• Impostare il valore dell'identificatore utente richiamando il metodo setUserId dell'oggetto PrincipalSearchFilter. Passa un valore stringa che rappresenta il valore dell'identificatore utente.
• Richiama il metodo findPrincipals dell'oggetto DirectoryManagerServiceClient e passa l'oggetto PrincipalSearchFilter. Questo metodo restituisce un'istanza java.util.List, in cui ogni elemento è un oggetto User. Scorrere l'istanza java.util.List per individuare l'utente da eliminare.

Elimina l’utente da AEM Forms.

Richiama il metodo deleteLocalUser dell'oggetto DirectoryManagerServiceClient e passa il valore del campo oid dell'oggetto User. Richiama il metodo getOid dell'oggetto User. Utilizzare l'oggetto User recuperato dall'istanza java.util.List.

Includi file di progetto.

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

Creare un client DirectoryManagerService.

• Creare un oggetto DirectoryManagerServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto DirectoryManagerServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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 l'attributo lc_version. Questo attributo viene utilizzato quando si crea un riferimento a un servizio. Assicurarsi di specificare blob=mtom.

• Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo DirectoryManagerServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito in BasicHttpBinding.

• Impostare il campo MessageEncoding dell'oggetto System.ServiceModel.BasicHttpBinding su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

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

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

Specificare l'utente da eliminare.

• Creare un oggetto PrincipalSearchFilter utilizzando il relativo costruttore.
• Impostare il valore dell'identificatore utente assegnando un valore stringa al campo userId dell'oggetto PrincipalSearchFilter.
• Richiama il metodo findPrincipals dell'oggetto DirectoryManagerServiceClient e passa l'oggetto PrincipalSearchFilter. Questo metodo restituisce un insieme MyArrayOfUser, dove ogni elemento è un oggetto User. Scorrere la raccolta MyArrayOfUser per individuare l'utente. L'oggetto User recuperato dall'insieme MyArrayOfUser viene utilizzato per eliminare l'utente.

Elimina l’utente da AEM Forms.

Eliminare l'utente passando il valore del campo oid dell'oggetto User al metodo deleteLocalUser dell'oggetto DirectoryManagerServiceClient.

Includi file di progetto.

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

Creare un client DirectoryManagerService.

Creare un oggetto DirectoryManagerServiceClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory che contiene proprietà di connessione.

Determinare se il gruppo esiste.

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

Crea il gruppo.

• Se il gruppo non esiste, richiamare il metodo setCommonName dell'oggetto Group e passare un valore stringa che specifichi il nome del gruppo.
• Richiama il metodo setDescription dell'oggetto Group e passa un valore stringa che specifica la descrizione del gruppo.
• Richiama il metodo setDomainName dell'oggetto Group e passa un valore stringa che specifica il nome di dominio.
• Richiama il metodo createLocalGroup dell'oggetto DirectoryManagerServiceClient e passa l'istanza Group.

Il metodo createLocalUser restituisce un valore stringa che specifica il valore dell'identificatore utente locale.

Eseguire un'azione con il gruppo.

• Creare un oggetto PrincipalSearchFilter utilizzando il relativo costruttore.
• Impostare il valore dell'identificatore utente richiamando il metodo setUserId dell'oggetto PrincipalSearchFilter. Passa un valore stringa che rappresenta il valore dell'identificatore utente.
• Richiama il metodo findPrincipals dell'oggetto DirectoryManagerServiceClient e passa l'oggetto PrincipalSearchFilter. Questo metodo restituisce un'istanza java.util.List, in cui ogni elemento è un oggetto User. Scorrere l'istanza java.util.List per individuare l'utente.
• Aggiungere un utente al gruppo richiamando il metodo addPrincipalToLocalGroup dell'oggetto DirectoryManagerServiceClient. Passa il valore restituito del metodo getOid dell'oggetto User. Passare il valore restituito del metodo getOid degli oggetti Group (utilizzare l'istanza Group che rappresenta il nuovo gruppo).

Includi file di progetto.

Includi i file JAR client, come adobe-usermanager-client.jar, nel percorso di classe del progetto Java. Per informazioni sul percorso di questi file, vedere Inclusi i file della libreria Java di AEM Forms.

Creare un client DirectoryManagerService.

Creare un oggetto DirectoryManagerServiceClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory che contiene proprietà di connessione. Per informazioni, vedere Impostazione delle proprietà di connessione.

Richiama le operazioni appropriate dell’utente o del gruppo.

Per trovare un utente o un gruppo, richiamare uno dei metodi dell'oggetto DirectoryManagerServiceClient per trovare le entità (poiché un'entità può essere un utente o un gruppo). Nell'esempio seguente, il metodo findPrincipals viene chiamato utilizzando un filtro di ricerca (un oggetto PrincipalSearchFilter).

Poiché in questo caso il valore restituito è un java.util.List contenente Principal oggetti, scorrere il risultato ed eseguire il cast degli oggetti Principal su User o Group.

Utilizzando l'oggetto User o Group risultante (entrambi ereditati dall'interfaccia Principal), recuperare le informazioni necessarie nei flussi di lavoro. Ad esempio, la combinazione dei valori del nome di dominio e del nome canonico identifica in modo univoco un’entità principale. Questi vengono recuperati richiamando i metodi getDomainName e getCanonicalName dell'oggetto Principal, rispettivamente.

Per eliminare un utente locale, richiamare il metodo deleteLocalUser dell'oggetto DirectoryManagerServiceClient e passare l'identificatore dell'utente.

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

Includi file di progetto.

• Creare un assembly client Microsoft .NET che utilizza il WSDL di Gestione directory. (Vedi Richiamare AEM Forms utilizzando la codifica Base64.)
• Fare riferimento all'assembly client Microsoft .NET. Vedere Creazione di un assembly client .NET che utilizza la codifica Base64.

Creare un client DirectoryManagerService.

Creare un oggetto DirectoryManagerServiceService utilizzando il costruttore della classe proxy.

Richiama le operazioni appropriate dell’utente o del gruppo.

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

Poiché in questo caso il valore restituito è un object[] contenente Principal oggetti, scorrere il risultato ed eseguire il cast degli oggetti Principal su User o Group.

Utilizzando l'oggetto User o Group risultante (entrambi ereditati dall'interfaccia Principal), recuperare le informazioni necessarie nei flussi di lavoro. Ad esempio, la combinazione dei valori del nome di dominio e del nome canonico identifica in modo univoco un’entità principale. Questi vengono recuperati richiamando rispettivamente i campi domainName e canonicalName dell'oggetto Principal.

Per eliminare un utente locale, richiamare il metodo deleteLocalUser dell'oggetto DirectoryManagerServiceService e passare l'identificatore dell'utente.

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

Includi file di progetto.

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

Creare un client AuthorizationManagerService.

Creare un oggetto AuthorizationManagerServiceClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory che contiene proprietà di connessione.

Richiama le operazioni di ruolo o autorizzazione appropriate.

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

• Un oggetto java.lang.String che contiene l'identificatore del ruolo
• Matrice di java.lang.String oggetti contenente gli identificatori principali.

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

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

Includi file di progetto.

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

Creare un client AuthorizationManagerService.

• Creare un oggetto AuthorizationManagerServiceClient utilizzando il relativo costruttore predefinito.

• Creare un oggetto AuthorizationManagerServiceClient.Endpoint.Address utilizzando il costruttore System.ServiceModel.EndpointAddress. 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 l'attributo lc_version. Questo attributo viene utilizzato quando si crea un riferimento a un servizio.

• Creare un oggetto System.ServiceModel.BasicHttpBinding ottenendo il valore del campo AuthorizationManagerServiceClient.Endpoint.Binding. Eseguire il cast del valore restituito in BasicHttpBinding.

• Impostare il campo MessageEncoding dell'oggetto System.ServiceModel.BasicHttpBinding su WSMessageEncoding.Mtom. Questo valore assicura che venga utilizzato MTOM.

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

  • Assegnare il nome utente dei moduli AEM al campo AuthorizationManagerServiceClient.ClientCredentials.UserName.UserName.
  • Assegnare il valore della password corrispondente al campo AuthorizationManagerServiceClient.ClientCredentials.UserName.Password.
  • Assegnare il valore costante HttpClientCredentialType.Basic al campo BasicHttpBindingSecurity.Transport.ClientCredentialType.
  • Assegnare 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 il metodo assignRole dell'oggetto AuthorizationManagerServiceClient e passare i valori seguenti:

• Un oggetto string che contiene l'identificatore del ruolo
• Oggetto MyArrayOf_xsd_string contenente gli identificatori principali.

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

• Oggetto string contenente l'identificatore del ruolo.
• Matrice di string oggetti contenente gli identificatori principali.

Includi file di progetto.

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

Creare un client AuthenticationManagerServices.

Creare un oggetto AuthenticationManagerServiceClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory che contiene proprietà di connessione.

Richiama l’operazione di autenticazione.

Richiama il metodo authenticate dell'oggetto AuthenticationManagerServiceClient e passa i seguenti valori:

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

Il metodo authenticate restituisce un oggetto AuthResult contenente informazioni sull'utente autenticato.

Recupera il contesto di autenticazione.

Richiama il metodo getContext dell'oggetto ServiceClientFactory, che restituirà un oggetto Context.

Quindi richiamare il metodo initPrincipal dell'oggetto Context e passare AuthResult.

Includi file di progetto.

• Creare un assembly client Microsoft .NET che utilizza il file WSDL di Authentication Manager. (Vedi Richiamare AEM Forms utilizzando la codifica Base64.)
• Fare riferimento all'assembly client Microsoft .NET. Vedere "Riferimento all'assembly client .NET" in Richiamare AEM Forms utilizzando la codifica Base64.

Creare un client AuthenticationManagerService.

Creare un oggetto AuthenticationManagerServiceService utilizzando il costruttore della classe proxy.

Richiama l’operazione di autenticazione.

Richiama il metodo authenticate dell'oggetto AuthenticationManagerServiceClient e passa i seguenti valori:

• Oggetto string contenente il nome dell'utente
• Matrice di byte (un oggetto byte[]) contenente la password dell'utente. È possibile ottenere l'oggetto byte[] convertendo un oggetto string contenente la password in un array byte[] utilizzando la logica illustrata nell'esempio seguente.
• Il valore restituito sarà un oggetto AuthResult che può essere utilizzato per recuperare informazioni sull'utente. Nell'esempio seguente, le informazioni dell'utente vengono recuperate ottenendo prima il campo authenticatedUser dell'oggetto AuthResult e successivamente i campi canonicalName e domainName dell'oggetto User risultante.

Includi file di progetto.

Includi i 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.

Creare un oggetto UserManagerUtilServiceClient utilizzando il relativo costruttore e passando un oggetto ServiceClientFactory che contiene proprietà di connessione.

Specificare il dominio enterprise.

• Richiama il metodo scheduleSynchronization dell'oggetto UserManagerUtilServiceClient per avviare l'operazione di sincronizzazione utente.
• Creare un'istanza java.util.Set utilizzando un costruttore HashSet. Assicurarsi di specificare String come tipo di dati. Questa istanza di Java.util.Set memorizza i nomi di dominio a cui si applica l'operazione di sincronizzazione.
• Per ogni nome di dominio da aggiungere, richiamare il metodo add dell'oggetto java.util.Set e passare il nome di dominio.

Richiama l’operazione di sincronizzazione.

Richiama il metodo getContext dell'oggetto ServiceClientFactory, che restituirà un oggetto Context.

Quindi richiamare il metodo initPrincipal dell'oggetto Context e passare AuthResult.