Gebruikers beheren managing-users

Gebruikers verwijderen

Gebruikers toevoegen met de Java API add-users-using-the-java-api

Voeg gebruikers toe met de API voor directoryservice (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-usermanager-client.jar, op in het klassenpad van uw Java-project.
Creeer een cliënt DirectoryManagerServices.

Een DirectoryManagerServiceClient object door de constructor ervan te gebruiken en een object door te geven ServiceClientFactory object dat verbindingseigenschappen bevat.

Gebruikersgegevens definiëren.

Een UserImpl object met behulp van de constructor.
Stel de naam van het domein in door de UserImpl object setDomainName methode. Geef een tekenreekswaarde door die de domeinnaam opgeeft.
Stel het hoofdtype in door het UserImpl object setPrincipalType methode. Geef een tekenreekswaarde door die het type gebruiker aangeeft. U kunt bijvoorbeeld USER.
Stel de waarde van de gebruikersidentificatie in door de UserImpl object setUserid methode. Geef een tekenreekswaarde door die de waarde van de gebruikersidentificatie aangeeft. U kunt bijvoorbeeld wblue.
Stel de canonieke naam in door de UserImpl object setCanonicalName methode. Geef een tekenreekswaarde door die de canonieke naam van de gebruiker aangeeft. U kunt bijvoorbeeld wblue.
Stel de opgegeven naam in door de UserImpl object setGivenName methode. Geef een tekenreekswaarde door die de opgegeven naam van de gebruiker aangeeft. U kunt bijvoorbeeld Wendy.
Stel de familienaam in door de UserImpl object setFamilyName methode. Geef een tekenreekswaarde door die de familienaam van de gebruiker aangeeft. U kunt bijvoorbeeld Blue.

note note
NOTE
Roep een methode aan die tot de `UserImpl` -object om andere waarden in te stellen. U kunt bijvoorbeeld de waarde van de landinstelling instellen door de `UserImpl` object `setLocale` methode.

Voeg de gebruiker toe aan AEM Forms.

De DirectoryManagerServiceClient object createLocalUser en geeft de volgende waarden door:
- De UserImpl object dat de nieuwe gebruiker vertegenwoordigt
- Een tekenreekswaarde die het wachtwoord van de gebruiker vertegenwoordigt
De createLocalUser Deze methode retourneert een tekenreekswaarde die de waarde van de lokale gebruikers-id opgeeft.
Controleer of de gebruiker is toegevoegd.
- Een PrincipalSearchFilter object met behulp van de constructor.
- Stel de waarde van de gebruikersidentificatie in door de PrincipalSearchFilter object setUserId methode. Geef een tekenreekswaarde door die de waarde van de gebruikersidentificatie vertegenwoordigt.
- De DirectoryManagerServiceClient object findPrincipals en geeft de PrincipalSearchFilter object. Deze methode retourneert een java.util.List instantie, waarbij elk element een User object. Doorlopen java.util.List -instantie om de gebruiker te zoeken.

Zie ook

Snel starten (SOAP-modus): Gebruikers toevoegen met de Java API

Gebruikers toevoegen met de webservice-API add-users-using-the-web-service-api

Voeg gebruikers toe met de API (webservice) van Directory Manager:

Inclusief projectbestanden.

Creeer een Microsoft .NET project dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL voor de de dienstverwijzing gebruikt: http://localhost:8080/soap/services/DirectoryManagerService?WSDL&lc_version=9.0.1.

note note
NOTE
Vervangen `localhost` met het IP-adres van de server die als host fungeert voor AEM Forms.

Creeer een cliënt DirectoryManagerService.
- Een DirectoryManagerServiceClient object met de standaardconstructor.
- Een DirectoryManagerServiceClient.Endpoint.Address object gebruiken System.ServiceModel.EndpointAddress constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom). U hoeft de lc_version kenmerk. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Zorg ervoor dat u opgeeft ?blob=mtom.
- Een System.ServiceModel.BasicHttpBinding object door de waarde van het object op te halen DirectoryManagerServiceClient.Endpoint.Binding veld. De geretourneerde waarde omzetten in BasicHttpBinding.
- Stel de System.ServiceModel.BasicHttpBinding object MessageEncoding veld naar WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam van het AEM aan het veld toe DirectoryManagerServiceClient.ClientCredentials.UserName.UserName.
  - De bijbehorende wachtwoordwaarde aan het veld toewijzen DirectoryManagerServiceClient.ClientCredentials.UserName.Password.
  - De constante waarde toewijzen HttpClientCredentialType.Basic naar het veld BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - De constante waarde toewijzen BasicHttpSecurityMode.TransportCredentialOnly naar het veld BasicHttpBindingSecurity.Security.Mode.
Gebruikersgegevens definiëren.
- Een UserImpl object met behulp van de constructor.
- Stel de naam van het domein in door een tekenreekswaarde toe te wijzen aan de UserImpl object domainName veld.
- Stel het hoofdtype in door een tekenreekswaarde toe te wijzen aan de UserImpl object principalType veld. U kunt bijvoorbeeld USER.
- Stel de waarde van de gebruikersidentificatie in door een tekenreekswaarde toe te wijzen aan de UserImpl object userid veld.
- Stel de canonieke naamwaarde in door een tekenreekswaarde toe te wijzen aan de UserImpl object canonicalName veld.
- Stel de opgegeven naamwaarde in door een tekenreekswaarde toe te wijzen aan de UserImpl object givenName veld.
- Stel de naam van de familie in door een tekenreekswaarde toe te wijzen aan de UserImpl object familyName veld.
Voeg de gebruiker toe aan AEM Forms.

De DirectoryManagerServiceClient object createLocalUser en geeft de volgende waarden door:
- De UserImpl object dat de nieuwe gebruiker vertegenwoordigt
- Een tekenreekswaarde die het wachtwoord van de gebruiker vertegenwoordigt
De createLocalUser Deze methode retourneert een tekenreekswaarde die de waarde van de lokale gebruikers-id opgeeft.
Controleer of de gebruiker is toegevoegd.
- Een PrincipalSearchFilter object met behulp van de constructor.
- Stel de waarde van de gebruikersidentificatie in door een tekenreekswaarde toe te wijzen die de waarde van de gebruikersidentificatie vertegenwoordigt PrincipalSearchFilter object userId veld.
- De DirectoryManagerServiceClient object findPrincipals en geeft de PrincipalSearchFilter object. Deze methode retourneert een MyArrayOfUser verzamelingsobject, waarbij elk element een User object. Doorlopen MyArrayOfUser verzameling om de gebruiker te zoeken.

Zie ook

AEM Forms aanroepen met SwaRef

Gebruikers verwijderen deleting-users

U kunt de API voor directoryservice (Java en webservice) gebruiken om gebruikers via programmacode uit AEM Forms te verwijderen. Nadat u een gebruiker schrapt, kan de gebruiker niet meer worden gebruikt om een de dienstverrichting uit te voeren die een gebruiker vereist. U kunt bijvoorbeeld geen taak toewijzen aan een verwijderde gebruiker.

Overzicht van de stappen summary_of_steps-1

Voer de volgende stappen uit om een gebruiker te verwijderen:

Inclusief projectbestanden.
Creeer een cliënt DirectoryManagerService.
Geef de gebruiker op die u wilt verwijderen.
Verwijder de gebruiker uit AEM Forms.

Projectbestanden opnemen

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, neemt u de proxybestanden op.

Een DirectoryManagerService-client maken

Alvorens u programmatically een verrichting van de Dienst API van de Manager van de Folder kunt uitvoeren, creeer een de dienstcliënt van de Manager van de Folder.

De gebruiker opgeven die moet worden verwijderd

U kunt opgeven dat een gebruiker moet worden verwijderd met de id-waarde van de gebruiker.

De gebruiker verwijderen uit AEM Forms

Als u een gebruiker wilt verwijderen, roept u de DirectoryManagerServiceClient object deleteLocalUser methode.

Zie ook

Gebruikers verwijderen met de Java API

Gebruikers verwijderen met de webservice-API

Gebruikers toevoegen

Gebruikers verwijderen met de Java API delete-users-using-the-java-api

Gebruikers verwijderen met de API voor directoryservice (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-usermanager-client.jar, op in het klassenpad van uw Java-project.
Creeer een cliënt DirectoryManagerService.

Een DirectoryManagerServiceClient object door de constructor ervan te gebruiken en een object door te geven ServiceClientFactory object dat verbindingseigenschappen bevat.
Geef de gebruiker op die u wilt verwijderen.
- Een PrincipalSearchFilter object met behulp van de constructor.
- Stel de waarde van de gebruikersidentificatie in door de PrincipalSearchFilter object setUserId methode. Geef een tekenreekswaarde door die de waarde van de gebruikersidentificatie vertegenwoordigt.
- De DirectoryManagerServiceClient object findPrincipals en geeft de PrincipalSearchFilter object. Deze methode retourneert een java.util.List instantie, waarbij elk element een User object. Doorlopen java.util.List -instantie om de te verwijderen gebruiker te zoeken.
Verwijder de gebruiker uit AEM Forms.

De DirectoryManagerServiceClient object deleteLocalUser en geeft u de waarde van de User object oid veld. De User object getOid methode. Gebruik de User object opgehaald uit het java.util.List -instantie.

Zie ook

Snel starten (EJB-modus): Gebruikers verwijderen met de Java API

Snel starten (SOAP-modus): Gebruikers verwijderen met de Java API

Gebruikers verwijderen met de webservice-API delete-users-using-the-web-service-api

Gebruikers verwijderen met de API voor directoryservice (webservice):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-usermanager-client.jar, op in het klassenpad van uw Java-project.
Creeer een cliënt DirectoryManagerService.
- Een DirectoryManagerServiceClient object met de standaardconstructor.
- Een DirectoryManagerServiceClient.Endpoint.Address object gebruiken System.ServiceModel.EndpointAddress constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom). U hoeft de lc_version kenmerk. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Zorg ervoor dat u opgeeft blob=mtom.
- Een System.ServiceModel.BasicHttpBinding object door de waarde van het object op te halen DirectoryManagerServiceClient.Endpoint.Binding veld. De geretourneerde waarde omzetten in BasicHttpBinding.
- Stel de System.ServiceModel.BasicHttpBinding object MessageEncoding veld naar WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam van het AEM aan het veld toe DirectoryManagerServiceClient.ClientCredentials.UserName.UserName.
  - De bijbehorende wachtwoordwaarde aan het veld toewijzen DirectoryManagerServiceClient.ClientCredentials.UserName.Password.
  - De constante waarde toewijzen HttpClientCredentialType.Basic naar het veld BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - De constante waarde toewijzen BasicHttpSecurityMode.TransportCredentialOnly naar het veld BasicHttpBindingSecurity.Security.Mode.
Geef de gebruiker op die u wilt verwijderen.
- Een PrincipalSearchFilter object met behulp van de constructor.
- Stel de waarde van de gebruikersidentificatie in door een tekenreekswaarde toe te wijzen aan de PrincipalSearchFilter object userId veld.
- De DirectoryManagerServiceClient object findPrincipals en geeft de PrincipalSearchFilter object. Deze methode retourneert een MyArrayOfUser verzamelingsobject, waarbij elk element een User object. Doorlopen MyArrayOfUser verzameling om de gebruiker te zoeken. De User object opgehaald uit het MyArrayOfUser verzamelingsobject wordt gebruikt om de gebruiker te verwijderen.
Verwijder de gebruiker uit AEM Forms.

Verwijder de gebruiker door de User object oid veldwaarde voor de DirectoryManagerServiceClient object deleteLocalUser methode.

Zie ook

AEM Forms aanroepen met SwaRef

Groepen maken creating-groups

Met de API voor directorybeheer (Java en webservice) kunt u programmatisch AEM Forms-groepen maken. Nadat u een groep creeert, kunt u die groep gebruiken om een de dienstverrichting uit te voeren die een groep vereist. U kunt bijvoorbeeld een gebruiker aan de nieuwe groep toewijzen. (Zie Gebruikers en groepen beheren.)

Overzicht van de stappen summary_of_steps-2

Voer de volgende stappen uit om een groep te maken:

Inclusief projectbestanden.
Creeer een cliënt DirectoryManagerService.
Bepaal of de groep niet bestaat.
Maak de groep.
Voer een handeling uit met de groep.

Projectbestanden opnemen

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op.

De volgende JAR-bestanden moeten worden toegevoegd aan het klassepad van uw project:

adobe-livecycle-client.jar
adobe-usermanager-client.jar
adobe-utilities.jar (Vereist als AEM Forms wordt geïmplementeerd op JBoss)
jbossall-client.jar (vereist als AEM Forms wordt geïmplementeerd op JBoss)

Voor informatie over de locatie van deze JAR-bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.

Een DirectoryManagerService-client maken

Alvorens u een de dienstverrichting van de Manager van de Folder programmatically kunt uitvoeren, creeer een cliënt van de Dienst API van de Manager van de Folder.

Bepalen of de groep bestaat

Wanneer u een groep maakt, moet u ervoor zorgen dat de groep niet in hetzelfde domein bestaat. Twee groepen kunnen dus niet dezelfde naam binnen hetzelfde domein hebben. Voor deze taak voert u een zoekopdracht uit en filtert u de zoekresultaten op basis van twee waarden. Het hoofdtype instellen op com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP om ervoor te zorgen dat alleen groepen worden geretourneerd. Zorg er ook voor dat u de domeinnaam opgeeft.

De groep maken

Nadat u hebt bepaald dat de groep niet bestaat in het domein, maakt u de groep en geeft u de volgende kenmerken op:

CommonName: De naam van de groep.
Domein: Het domein waarin de groep wordt toegevoegd.
Beschrijving: Een beschrijving van de groep.

Een handeling uitvoeren met de groep

Nadat u een groep hebt gemaakt, kunt u een actie uitvoeren met de groep. U kunt bijvoorbeeld een gebruiker aan de groep toevoegen. Als u een gebruiker aan een groep wilt toevoegen, haalt u de unieke id-waarde van zowel de gebruiker als de groep op. Geef deze waarden door aan addPrincipalToLocalGroup methode.

Zie ook

Groepen maken met de Java API

Gebruikers toevoegen

Gebruikers verwijderen

Groepen maken met de Java API create-groups-using-the-java-api

Maak een groep met de API voor directoryservice (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-usermanager-client.jar, op in het klassenpad van uw Java-project.
Creeer een cliënt DirectoryManagerService.

Een DirectoryManagerServiceClient object door de constructor ervan te gebruiken en een object door te geven ServiceClientFactory object dat verbindingseigenschappen bevat.
Bepaal of de groep bestaat.
- Een PrincipalSearchFilter object met behulp van de constructor.
- Stel het hoofdtype in door het PrincipalSearchFilter object setPrincipalType object. Geef de waarde door com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP.
- Stel het domein in door het PrincipalSearchFilter object setSpecificDomainName object. Geef een tekenreekswaarde door die de domeinnaam opgeeft.
- Als u een groep wilt zoeken, roept u de DirectoryManagerServiceClient object findPrincipals methode (een principal kan een groep zijn). Geef de PrincipalSearchFilter object dat het hoofdtype en de domeinnaam opgeeft. Deze methode retourneert een java.util.List instantie waarbij elk element een Group -instantie. Elke groepsinstantie is in overeenstemming met het filter dat is opgegeven met het PrincipalSearchFilter object.
- Doorlopen java.util.List -instantie. Haal voor elk element de groepsnaam op. Zorg ervoor dat de groepsnaam niet gelijk is aan de nieuwe groepsnaam.
Maak de groep.
- Als de groep niet bestaat, roept u Group object setCommonName methode en geef een tekenreekswaarde door die de groepsnaam opgeeft.
- De Group object setDescription methode en geef een tekenreekswaarde door die de groepsbeschrijving aangeeft.
- De Group object setDomainName en geeft een tekenreekswaarde door die de domeinnaam opgeeft.
- De DirectoryManagerServiceClient object createLocalGroup en geeft de Group -instantie.
De createLocalUser Deze methode retourneert een tekenreekswaarde die de waarde van de lokale gebruikers-id opgeeft.
Voer een handeling uit met de groep.
- Een PrincipalSearchFilter object met behulp van de constructor.
- Stel de waarde van de gebruikersidentificatie in door de PrincipalSearchFilter object setUserId methode. Geef een tekenreekswaarde door die de waarde van de gebruikersidentificatie vertegenwoordigt.
- De DirectoryManagerServiceClient object findPrincipals en geeft de PrincipalSearchFilter object. Deze methode retourneert een java.util.List instantie, waarbij elk element een User object. Doorlopen java.util.List -instantie om de gebruiker te zoeken.
- Voeg een gebruiker aan de groep toe door het DirectoryManagerServiceClient object addPrincipalToLocalGroup methode. Geef de geretourneerde waarde van het dialoogvenster door User object getOid methode. Geef de geretourneerde waarde van het dialoogvenster door Group objecten getOid methode (gebruik de Group -instantie die de nieuwe groep vertegenwoordigt).

Zie ook

Gebruikers en groepen beheren met de Java API

Gebruikers en groepen beheren managing-users-and-groups

Dit onderwerp beschrijft hoe u (Java) kunt gebruiken om, domeinen, gebruikers, en groepen programmatically toe te wijzen te verwijderen.

NOTE

Wanneer het vormen van een domein, moet u het unieke herkenningsteken voor groepen en gebruikers plaatsen. Het kenmerk dat wordt gekozen, moet niet alleen uniek zijn binnen de LDAP-omgeving, maar moet ook onveranderlijk zijn en niet worden gewijzigd binnen de directory. Dit attribuut moet ook van een eenvoudig type van koordgegevens zijn (de enige uitzondering momenteel toegestaan voor Actieve Folder 2000/2003 is "objectsid", wat een binaire waarde is). Het kenmerk Novell eDirectory "GUID"Dit is bijvoorbeeld geen eenvoudig gegevenstype voor tekenreeksen en werkt dus niet.

Voor Actieve Folder, gebruik "objectsid".
Gebruik voor SunOne "nsuniqueid".

NOTE

Het maken van meerdere lokale gebruikers en groepen terwijl een LDAP-directorysynchronisatie wordt uitgevoerd, wordt niet ondersteund. Als u dit proces probeert uit te voeren, kunnen er fouten optreden.

Overzicht van de stappen summary_of_steps-3

Voer de volgende stappen uit om gebruikers en groepen te beheren:

Inclusief projectbestanden.
Creeer een cliënt DirectoryManagerService.
Roep de juiste gebruikers- of groepsbewerkingen aan.

Projectbestanden opnemen

Neem de benodigde bestanden op in uw ontwikkelingsproject. Als u een clienttoepassing maakt met Java, neemt u de benodigde JAR-bestanden op. Als u webservices gebruikt, moet u ervoor zorgen dat u de proxybestanden opneemt.

Een DirectoryManagerService-client maken

Alvorens u een de dienstverrichting van de Manager van de Folder programmatically kunt uitvoeren, moet u een de dienstcliënt van de Manager van de Folder creëren. Met de Java API wordt dit bereikt door een DirectoryManagerServiceClient object. Met de webservice-API kunt u dit bereiken door een DirectoryManagerServiceService object.

De juiste gebruikers- of groepsbewerkingen aanroepen

Zodra u de de dienstcliënt hebt gecreeerd, kunt u de gebruiker of de verrichtingen van het groepsbeheer dan aanhalen. De de dienstcliënt staat u toe om, domeinen, gebruiker, en groepen toe te wijzen te verwijderen. Merk op dat het of een folderhoofd of een lokale hoofd aan een lokale groep kan toevoegen, maar het is niet mogelijk om een lokale hoofd aan een foldergroep toe te voegen.

Zie ook

Gebruikers en groepen beheren met de webservice-API

Gebruikers en groepen beheren met de Java API managing-users-and-groups-using-the-java-api

Voer de volgende taken uit om gebruikers, groepen en domeinen programmatisch te beheren met behulp van de map (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-usermanager-client.jar, op in het klassenpad van uw Java-project. Voor informatie over de locatie van deze bestanden raadpleegt u Inclusief AEM Forms Java-bibliotheekbestanden.
Creeer een cliënt DirectoryManagerService.

Een DirectoryManagerServiceClient object door de constructor ervan te gebruiken en een object door te geven ServiceClientFactory object dat verbindingseigenschappen bevat. Zie voor meer informatie Verbindingseigenschappen instellen.
Roep de juiste gebruikers- of groepsbewerkingen aan.

Als u een gebruiker of groep wilt zoeken, roept u een van de DirectoryManagerServiceClient de methodes van objecten om hoofden (aangezien een hoofd een gebruiker of een groep kan zijn) te vinden. In het onderstaande voorbeeld wordt findPrincipals methode wordt aangeroepen met een zoekfilter (een PrincipalSearchFilter object).

Aangezien de geretourneerde waarde in dit geval een java.util.List bevattende Principal objecten, doorloopt het resultaat en cast het Principal objecten naar een van beide User of Group objecten.

Het resultaat gebruiken User of Group object (dat beide van het Principal ), haalt u de informatie op die u in uw workflows nodig hebt. De domeinnaam en canonieke naamwaarden vormen samen bijvoorbeeld een unieke identificatie van een principal. Deze worden teruggewonnen door te roepen Principal object getDomainName en getCanonicalName methoden, respectievelijk.

Als u een lokale gebruiker wilt verwijderen, roept u de DirectoryManagerServiceClient object deleteLocalUser en geeft u de id van de gebruiker door.

Als u een lokale groep wilt verwijderen, roept u de opdracht DirectoryManagerServiceClient object deleteLocalGroup en geeft u de id van de groep door.

Zie ook

Gebruikers en groepen beheren met de webservice-API managing-users-and-groups-using-the-web-service-api

Om gebruikers, groepen, en domeinen programmatically te beheren gebruikend de Dienst API van de Manager van de Folder (Webdienst), voer de volgende taken uit:

Inclusief projectbestanden.
- Creeer een Microsoft .NET cliëntassemblage die de Manager WSDL van de Folder verbruikt. (Zie AEM Forms aanroepen met Base64-codering.)
- Verwijs naar de Microsoft .NET cliëntassemblage. (Zie Creërend een .NET cliëntassemblage die het coderen Base64 gebruikt.)
Creeer een cliënt DirectoryManagerService.

Een DirectoryManagerServiceService object met de constructor van de proxyklasse.

Roep de juiste gebruikers- of groepsbewerkingen aan.

Als u een gebruiker of groep wilt zoeken, roept u een van de DirectoryManagerServiceService de methodes van objecten om hoofden (aangezien een hoofd een gebruiker of een groep kan zijn) te vinden. In het onderstaande voorbeeld wordt findPrincipalsWithFilter methode wordt aangeroepen met een zoekfilter (een PrincipalSearchFilter object). Wanneer u een PrincipalSearchFilter object, lokale hoofden worden alleen geretourneerd als de isLocal eigenschap is ingesteld op true. Dit gedrag is anders dan wat er zou gebeuren met de Java API.

note note

NOTE

Als het maximale aantal resultaten niet is opgegeven in het zoekfilter (via de PrincipalSearchFilter.resultsMax (veld), worden maximaal 1000 resultaten geretourneerd. Dit gedrag is anders dan wat er gebeurt met de Java API, waarbij 10 resultaten het standaardmaximum zijn. Ook de zoekmethoden, zoals findGroupMembers geen resultaten oplevert, tenzij het maximale aantal resultaten is opgegeven in het zoekfilter (bijvoorbeeld via GroupMembershipSearchFilter.resultsMax veld). Dit is van toepassing op alle zoekfilters die overerven van de GenericSearchFilter klasse. Zie voor meer informatie AEM Forms API-naslag.

Aangezien de geretourneerde waarde in dit geval een object[] bevattende Principal objecten, doorloopt het resultaat en cast het Principal objecten naar een van beide User of Group objecten.

Het resultaat gebruiken User of Group object (dat beide van het Principal ), haalt u de informatie op die u in uw workflows nodig hebt. De domeinnaam en canonieke naamwaarden vormen samen bijvoorbeeld een unieke identificatie van een principal. Deze worden teruggewonnen door te roepen Principal object domainName en canonicalName respectievelijk velden.

Als u een lokale gebruiker wilt verwijderen, roept u de DirectoryManagerServiceService object deleteLocalUser en geeft u de id van de gebruiker door.

Als u een lokale groep wilt verwijderen, roept u de opdracht DirectoryManagerServiceService object deleteLocalGroup en geeft u de id van de groep door.

Zie ook

Rollen en machtigingen beheren met de Java API

Rollen en machtigingen beheren managing-roles-and-permissions

Dit onderwerp beschrijft hoe u de Dienst API van de Manager van de Vergunning (Java) kunt gebruiken om, rollen en toestemmingen programmatically toe te wijzen te verwijderen en te bepalen.

In AEM Forms rol is een groep toestemmingen voor de toegang tot van één of meerdere systeem-vlakke middelen. Deze toestemmingen worden gecreeerd door het Beheer van de Gebruiker en door de de dienstcomponenten afgedwongen. Een beheerder kan bijvoorbeeld de rol "Policy Set Author" aan een groep gebruikers toewijzen. Het Rights Management zou dan de gebruikers van die groep met die rol toestaan om beleidsreeksen door beleidsconsole tot stand te brengen.

Er zijn twee soorten rollen: standaardrollen en aangepaste rollen. Standaardrollen (systeemrollen) reeds in AEM Forms woonachtig zijn. Aangenomen wordt dat standaardrollen niet door de beheerder kunnen worden verwijderd of gewijzigd en dus onveranderlijk zijn. Aangepaste rollen die door de beheerder zijn gemaakt en die vervolgens kunnen worden gewijzigd of verwijderd, zijn dus veranderbaar.

Rollen maken het eenvoudiger om machtigingen te beheren. Wanneer een rol aan een hoofd wordt toegewezen, wordt een reeks toestemmingen automatisch toegewezen aan dat hoofd, en alle specifieke op toegang betrekking hebbende besluiten voor het hoofd zijn gebaseerd op die algemene reeks toegewezen toestemmingen.

Overzicht van de stappen summary_of_steps-4

Voer de volgende stappen uit om rollen en machtigingen te beheren:

Inclusief projectbestanden.
Maak een AuthorizationManagerService-client.
Roep de juiste rol- of machtigingsbewerkingen aan.

Projectbestanden opnemen

Een AuthorizationManagerService-client maken

Alvorens u een verrichting van AuthorizationManagerService van het Beheer van de Gebruiker programmatically kunt uitvoeren, moet u een cliënt AuthorizationManagerService tot stand brengen. Met de Java API wordt dit bereikt door een AuthorizationManagerServiceClient object.

De juiste rol- of machtigingsbewerkingen aanroepen

Zodra u de de dienstcliënt hebt gecreeerd, kunt u de rol of toestemmingsverrichtingen dan aanhalen. De de dienstcliënt staat u toe om, rollen en toestemmingen toe te wijzen te verwijderen en te bepalen.

Zie ook

Rollen en machtigingen beheren met de webservice-API

Rollen en machtigingen beheren met de Java API managing-roles-and-permissions-using-the-java-api

Voer de volgende taken uit om rollen en machtigingen te beheren met de API (Java) voor machtigingsbeheer:

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-usermanager-client.jar, op in het klassenpad van uw Java-project.
Maak een AuthorizationManagerService-client.

Een AuthorizationManagerServiceClient object door de constructor ervan te gebruiken en een object door te geven ServiceClientFactory object dat verbindingseigenschappen bevat.
Roep de juiste rol- of machtigingsbewerkingen aan.

Om een rol aan een hoofd toe te wijzen, haal AuthorizationManagerServiceClient object assignRole en geeft de volgende waarden door:
- A java.lang.String object dat de rol-id bevat
- Een array van java.lang.String objecten met de belangrijkste id's.
Om een rol uit een hoofd te verwijderen, haal AuthorizationManagerServiceClient object unassignRole en geeft de volgende waarden door:
- A java.lang.String object dat de rol-id bevat.
- Een array van java.lang.String objecten met de belangrijkste id's.

Zie ook

Snel starten (SOAP-modus): Rollen en machtigingen beheren met de Java API

Rollen en machtigingen beheren met de webservice-API managing-roles-and-permissions-using-the-web-service-api

Rollen en machtigingen beheren met behulp van de API (webservice) voor machtigingsbeheer:

Inclusief projectbestanden.

Creeer een Microsoft .NET project dat MTOM gebruikt. Zorg ervoor dat u de volgende definitie van WSDL gebruikt: http://localhost:8080/soap/services/AuthorizationManagerService?WSDL&lc_version=9.0.1.

note note
NOTE
Vervangen `localhost` met het IP-adres van de server die als host fungeert voor AEM Forms.

Maak een AuthorizationManagerService-client.
- Een AuthorizationManagerServiceClient object met de standaardconstructor.
- Een AuthorizationManagerServiceClient.Endpoint.Address object gebruiken System.ServiceModel.EndpointAddress constructor. Geef een tekenreekswaarde die de WSDL opgeeft door aan de AEM Forms-service (bijvoorbeeld http://localhost:8080/soap/services/AuthorizationManagerService?blob=mtom.) U hoeft de lc_version kenmerk. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.
- Een System.ServiceModel.BasicHttpBinding object door de waarde van het object op te halen AuthorizationManagerServiceClient.Endpoint.Binding veld. De geretourneerde waarde omzetten in BasicHttpBinding.
- Stel de System.ServiceModel.BasicHttpBinding object MessageEncoding veld naar WSMessageEncoding.Mtom. Deze waarde zorgt ervoor dat MTOM wordt gebruikt.
- Laat basisauthentificatie van HTTP door de volgende taken uit te voeren toe:
  - Wijs de gebruikersnaam van het AEM aan het veld toe AuthorizationManagerServiceClient.ClientCredentials.UserName.UserName.
  - De bijbehorende wachtwoordwaarde aan het veld toewijzen AuthorizationManagerServiceClient.ClientCredentials.UserName.Password.
  - De constante waarde toewijzen HttpClientCredentialType.Basic naar het veld BasicHttpBindingSecurity.Transport.ClientCredentialType.
  - De constante waarde toewijzen BasicHttpSecurityMode.TransportCredentialOnly naar het veld BasicHttpBindingSecurity.Security.Mode.
Roep de juiste rol- of machtigingsbewerkingen aan.

Om een rol aan een hoofd toe te wijzen, haal AuthorizationManagerServiceClient object assignRole en geeft de volgende waarden door:
- A string object dat de rol-id bevat
- A MyArrayOf_xsd_string object dat de belangrijkste id's bevat.
Om een rol uit een hoofd te verwijderen, haal AuthorizationManagerServiceService object unassignRole en geeft de volgende waarden door:
- A string object dat de rol-id bevat.
- Een array van string objecten met de belangrijkste id's.

Zie ook

Gebruikers verifiëren authenticating-users

In dit onderwerp wordt beschreven hoe u de API (Java) voor verificatiebeheer kunt gebruiken om uw clienttoepassingen in staat te stellen gebruikers programmatisch te verifiëren.

Mogelijk is gebruikersverificatie vereist voor interactie met een ondernemingsdatabase of andere opslagruimten voor bedrijfsgegevens die beveiligde gegevens opslaan.

Neem bijvoorbeeld een scenario waarin een gebruiker een gebruikersnaam en wachtwoord invoert op een webpagina en de waarden verzendt naar een J2EE-toepassingsserver die als host fungeert voor Forms. Een aangepaste Forms-toepassing kan de gebruiker verifiëren met de service Verificatiebeheer.

Als de authentificatie succesvol is, heeft de toepassing toegang tot een beveiligd ondernemingsgegevensbestand. Anders wordt een bericht naar de gebruiker verzonden waarin wordt aangegeven dat de gebruiker geen geautoriseerde gebruiker is.

Het volgende diagram toont de logische stroom van de toepassing.

au_au_umauth_process

De volgende lijst beschrijft de stappen in dit diagram

Stap

Beschrijving

De gebruiker heeft toegang tot een website en geeft een gebruikersnaam en wachtwoord op. Deze informatie wordt verzonden naar een J2EE-toepassingsserver die als host fungeert voor AEM Forms.

De gebruikersgegevens worden geverifieerd met de service Verificatiebeheer. Als de gebruikersgegevens geldig zijn, gaat de workflow naar stap 3. Anders wordt een bericht naar de gebruiker verzonden waarin wordt aangegeven dat de gebruiker geen geautoriseerde gebruiker is.

Gebruikersgegevens en een formulierontwerp worden opgehaald uit een beveiligde ondernemingsdatabase.

Gebruikersgegevens worden samengevoegd met een formulierontwerp en het formulier wordt weergegeven aan de gebruiker.

Overzicht van de stappen summary_of_steps-5

Voer de volgende stappen uit om een gebruiker programmatisch te verifiëren:

Inclusief projectbestanden.
Maak een AuthenticationManagerService-client.
Roep de verificatiebewerking aan.
Indien nodig, wint de context terug zodat de cliënttoepassing het aan een andere dienst van AEM Forms voor authentificatie kan door:sturen.

Projectbestanden opnemen

Een AuthenticationManagerService-client maken

Alvorens u een gebruiker programmatically kunt voor authentiek verklaren, moet u een cliënt tot stand brengen AuthenticationManagerService. Als u de Java API gebruikt, maakt u een AuthenticationManagerServiceClient object.

De verificatiebewerking aanroepen

Zodra u de de dienstcliënt hebt gecreeerd, kunt u de authentificatieverrichting dan aanhalen. Voor deze bewerking is informatie over de gebruiker nodig, zoals de naam en het wachtwoord van de gebruiker. Als de gebruiker niet verifieert, wordt een uitzondering geworpen.

De verificatiecontext ophalen

Nadat u de gebruiker hebt geverifieerd, kunt u een context maken op basis van de geverifieerde gebruiker. Vervolgens kunt u de inhoud gebruiken om een andere AEM Forms-service aan te roepen. U kunt de context bijvoorbeeld gebruiken om een EncryptionServiceClient en versleutelen van een PDF-document met een wachtwoord. Zorg ervoor dat de gebruiker die voor authentiek werd verklaard de genoemde rol heeft Services User die vereist is om een AEM Forms-service aan te roepen.

Zie ook

PDF-documenten versleutelen met een wachtwoord

Gebruikers verifiëren met de Java API authenticate-a-user-using-the-java-api

Verifieer een gebruiker gebruikend de Dienst API van de Manager van de Authentificatie (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-usermanager-client.jar, op in het klassenpad van uw Java-project.
Creeer een cliënt AuthenticationManagerServices.

Een AuthenticationManagerServiceClient object door de constructor ervan te gebruiken en een object door te geven ServiceClientFactory object dat verbindingseigenschappen bevat.
Roep de verificatiebewerking aan.

De AuthenticationManagerServiceClient object authenticate en geeft de volgende waarden door:
- A java.lang.String object dat de naam van de gebruiker bevat.
- Een bytearray (a byte[] object) met het wachtwoord van de gebruiker. U kunt de byte[] door het object aan te roepen java.lang.String object getBytes methode.
De methode authenticate retourneert een AuthResult object, dat informatie bevat over de geverifieerde gebruiker.
Haal de verificatiecontext op.

De ServiceClientFactory object getContext methode, die een Context object.

Roep vervolgens het Context object initPrincipal en geeft de AuthResult.

Gebruikers verifiëren met de webservice-API authenticate-a-user-using-the-web-service-api

Verifieer een gebruiker gebruikend de Dienst API van de Manager van de Authentificatie (Webdienst):

Inclusief projectbestanden.
- Creeer een Microsoft .NET cliëntassemblage die de Manager WSDL van de Authentificatie verbruikt. (Zie AEM Forms aanroepen met Base64-codering.)
- Verwijs naar de Microsoft .NET cliëntassemblage. (Zie "Verwijzen van de .NET cliëntassemblage"in AEM Forms aanroepen met Base64-codering.)
Maak een AuthenticationManagerService-client.

Een AuthenticationManagerServiceService object met de constructor van de proxyklasse.
Roep de verificatiebewerking aan.

De AuthenticationManagerServiceClient object authenticate en geeft de volgende waarden door:
- A string object dat de naam van de gebruiker bevat
- Een bytearray (a byte[] object) met het wachtwoord van de gebruiker. U kunt de byte[] object door een string object met het wachtwoord naar een byte[] met behulp van de logica in het onderstaande voorbeeld.
- De geretourneerde waarde is een AuthResult -object, dat kan worden gebruikt om informatie over de gebruiker op te halen. In het onderstaande voorbeeld wordt de informatie van de gebruiker opgehaald door eerst het AuthResult object authenticatedUser en vervolgens het resultaat User object canonicalName en domainName velden.

Zie ook

AEM Forms aanroepen met SwaRef

Gebruikers programmatisch synchroniseren programmatically-synchronizing-users

U kunt gebruikers programmatically synchroniseren door de API van het Beheer van de Gebruiker te gebruiken. Wanneer u gebruikers synchroniseert, werkt u AEM Forms bij met gebruikersgegevens in uw gegevensopslagruimte. Stel bijvoorbeeld dat u nieuwe gebruikers toevoegt aan de gegevensopslagruimte van uw gebruiker. Nadat u een synchronisatiebewerking hebt uitgevoerd, worden de nieuwe gebruikers AEM formuliergebruikers. Ook gebruikers die niet meer in je gebruikerslijst staan, worden uit AEM Forms verwijderd.

In het volgende diagram ziet u hoe AEM Forms synchroniseert met een gebruikersinterface.

ps_ps_umauth_sync

De volgende lijst beschrijft de stappen in dit diagram

Stap

Beschrijving

Een clienttoepassing vraagt of AEM Forms een synchronisatiebewerking uitvoert.

AEM Forms voert een synchronisatiebewerking uit.

Gebruikersgegevens worden bijgewerkt.

Een gebruiker kan de bijgewerkte gebruikersinformatie bekijken.

Overzicht van de stappen summary_of_steps-6

Voer de volgende stappen uit om gebruikers programmatisch te synchroniseren:

Inclusief projectbestanden.
Maak een UserManagerUtilServiceClient-client.
Geef het ondernemingsdomein op.
Roep de verificatiebewerking aan.
Bepalen of de synchronisatiebewerking is voltooid

Projectbestanden opnemen

Een UserManagerUtilServiceClientclient maken

Voordat u gebruikers programmatisch kunt synchroniseren, moet u een UserManagerUtilServiceClient object.

Het ondernemingsdomein opgeven

Voordat u een synchronisatiebewerking uitvoert met de API voor gebruikersbeheer, geeft u het ondernemingsdomein op waartoe gebruikers behoren. U kunt een of meerdere ondernemingsdomeinen opgeven. Alvorens u een synchronisatieverrichting programmatically kunt uitvoeren, moet u een ondernemingsdomein opstelling gebruikend de Console van het Beleid. (Zie administratie Help.)

De synchronisatiebewerking aanroepen

Nadat u een of meer ondernemingsdomeinen hebt opgegeven, kunt u de synchronisatiebewerking uitvoeren. De tijd die nodig is om deze bewerking uit te voeren, is afhankelijk van het aantal gebruikersrecords in de gegevensopslagruimte van de gebruiker.

Bepalen of de synchronisatiebewerking is voltooid

Nadat u programmatically een synchronisatieverrichting uitvoert, kunt u bepalen als de verrichting volledig is.

Zie ook

PDF-documenten versleutelen met een wachtwoord

Gebruikers programmatisch synchroniseren met de Java API programmatically-synchronizing-users-using-the-java-api

Gebruikers synchroniseren met de API voor gebruikersbeheer (Java):

Inclusief projectbestanden.

Neem client-JAR-bestanden, zoals adobe-usermanager-client.jar en adobe-usermanager-util-client.jar, op in het klassenpad van uw Java-project.
Maak een UserManagerUtilServiceClient-client.

Een UserManagerUtilServiceClient object door de constructor ervan te gebruiken en een object door te geven ServiceClientFactory object dat verbindingseigenschappen bevat.
Geef het ondernemingsdomein op.
- De UserManagerUtilServiceClient object scheduleSynchronization methode om de gebruikerssynchronisatiebewerking te starten.
- Een java.util.Set instantie door een HashSet constructor. Zorg ervoor dat u opgeeft String als het gegevenstype. Dit Java.util.Set slaat de instantie de domeinnamen op waarop de synchronisatiebewerking van toepassing is.
- Voor elke domeinnaam die moet worden toegevoegd, roept u het java.util.Set voegt methode toe en geeft de domeinnaam door.
Roep de synchronisatiebewerking aan.

De ServiceClientFactory object getContext methode, die een Context object.

Roep vervolgens het Context object initPrincipal en geeft de AuthResult.

Zie ook

Gebruikers programmatisch synchroniseren