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.

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

Gebruikersgegevens definiëren.

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

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

Voeg de gebruiker toe aan AEM Forms.

Roep de methode createLocalUser van het object DirectoryManagerServiceClient aan en geef de volgende waarden door:
- Het UserImpl -object dat de nieuwe gebruiker vertegenwoordigt
- Een tekenreekswaarde die het wachtwoord van de gebruiker vertegenwoordigt
De methode createLocalUser retourneert een tekenreekswaarde die de lokale id-waarde van de gebruiker opgeeft.
Controleer of de gebruiker is toegevoegd.
- Maak een PrincipalSearchFilter -object met behulp van de constructor.
- Stel de waarde van de gebruikersidentificatie in door de methode setUserId van het object PrincipalSearchFilter aan te roepen. Geef een tekenreekswaarde door die de waarde van de gebruikersidentificatie vertegenwoordigt.
- Roep de methode findPrincipals van het object DirectoryManagerServiceClient aan en geef het object PrincipalSearchFilter door. Deze methode retourneert een java.util.List -instantie, waarbij elk element een User -object is. Doorloop de instantie van java.util.List 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. Controleer of u de volgende WSDL-definitie gebruikt voor de serviceverwijzing: http://localhost:8080/soap/services/DirectoryManagerService?WSDL&lc_version=9.0.1 .

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

Creeer een cliënt DirectoryManagerService.
- Maak een DirectoryManagerServiceClient -object met de standaardconstructor.
- Maak een DirectoryManagerServiceClient.Endpoint.Address -object met de 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 het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Zorg ervoor dat u ?blob=mtom opgeeft.
- Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het DirectoryManagerServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .
- Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object in op 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 DirectoryManagerServiceClient.ClientCredentials.UserName.UserName toe.
  - Wijs de bijbehorende wachtwoordwaarde toe aan het veld DirectoryManagerServiceClient.ClientCredentials.UserName.Password .
  - Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
  - Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .
Gebruikersgegevens definiëren.
- Maak een UserImpl -object met behulp van de constructor.
- Stel de naam van het domein in door een tekenreekswaarde toe te wijzen aan het veld domainName van het UserImpl -object.
- Stel het hoofdtype in door een tekenreekswaarde toe te wijzen aan het veld principalType van het UserImpl -object. U kunt bijvoorbeeld USER opgeven.
- Stel de waarde van de gebruikersidentificatie in door een tekenreekswaarde toe te wijzen aan het veld userid van het UserImpl -object.
- Stel de canonieke naamwaarde in door een tekenreekswaarde toe te wijzen aan het veld canonicalName van het UserImpl -object.
- Stel de opgegeven naamwaarde in door een tekenreekswaarde toe te wijzen aan het veld givenName van het UserImpl -object.
- Stel de naam van de familie in door een tekenreekswaarde toe te wijzen aan het veld familyName van het UserImpl -object.
Voeg de gebruiker toe aan AEM Forms.

Roep de methode createLocalUser van het object DirectoryManagerServiceClient aan en geef de volgende waarden door:
- Het UserImpl -object dat de nieuwe gebruiker vertegenwoordigt
- Een tekenreekswaarde die het wachtwoord van de gebruiker vertegenwoordigt
De methode createLocalUser retourneert een tekenreekswaarde die de lokale id-waarde van de gebruiker opgeeft.
Controleer of de gebruiker is toegevoegd.
- Maak een PrincipalSearchFilter -object met behulp van de constructor.
- Stel de gebruiker-id-waarde van de gebruiker in door een tekenreekswaarde toe te wijzen die de gebruiker-id-waarde vertegenwoordigt aan het veld userId van het PrincipalSearchFilter -object.
- Roep de methode findPrincipals van het object DirectoryManagerServiceClient aan en geef het object PrincipalSearchFilter door. Deze methode retourneert een MyArrayOfUser -verzamelingsobject, waarbij elk element een User -object is. Doorloop de 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.

omvat projectdossiers

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.

creeer een cliënt DirectoryManagerService

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.

specificeer de te schrappen gebruiker

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

Schrap de gebruiker van AEM Forms

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

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.

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

Roep de methode deleteLocalUser van het object DirectoryManagerServiceClient aan en geef de waarde van het veld oid van het object User door. Roep de methode getOid van het object User aan. Gebruik het User -object dat is opgehaald uit de 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.
- Maak een DirectoryManagerServiceClient -object met de standaardconstructor.
- Maak een DirectoryManagerServiceClient.Endpoint.Address -object met de 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 het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt. Zorg ervoor dat u opgeeft blob=mtom.
- Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het DirectoryManagerServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .
- Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object in op 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 DirectoryManagerServiceClient.ClientCredentials.UserName.UserName toe.
  - Wijs de bijbehorende wachtwoordwaarde toe aan het veld DirectoryManagerServiceClient.ClientCredentials.UserName.Password .
  - Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
  - Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .
Geef de gebruiker op die u wilt verwijderen.
- Maak een PrincipalSearchFilter -object met behulp van de constructor.
- Stel de waarde van de gebruikersidentificatie in door een tekenreekswaarde toe te wijzen aan het veld userId van het PrincipalSearchFilter -object.
- Roep de methode findPrincipals van het object DirectoryManagerServiceClient aan en geef het object PrincipalSearchFilter door. Deze methode retourneert een MyArrayOfUser -verzamelingsobject, waarbij elk element een User -object is. Doorloop de MyArrayOfUser -verzameling om de gebruiker te zoeken. Het User -object dat is opgehaald uit het MyArrayOfUser -verzamelingsobject, wordt gebruikt om de gebruiker te verwijderen.
Verwijder de gebruiker uit AEM Forms.

Verwijder de gebruiker door de veldwaarde oid van het User -object door te geven aan de methode DirectoryManagerServiceClient van het object deleteLocalUser .

zie ook

AEM Forms aanroepen met SwaRef

Groepen maken creating-groups

U kunt de API voor directoryservice (Java en webservice) gebruiken om AEM Forms-groepen programmatisch te 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 het Leiden Gebruikers en Groepen.)

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.

omvat projectdossiers

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 plaats van deze JAR dossiers, zie Inclusief de bibliotheekdossiers van AEM Forms Java.

creeer een cliënt DirectoryManagerService

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.

bepaalt 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. Stel het hoofdtype in 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.

creeer de groep

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.

voer een actie met de groep uit

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 de methode addPrincipalToLocalGroup .

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.

Maak een DirectoryManagerServiceClient -object door de constructor ervan te gebruiken en een ServiceClientFactory -object door te geven dat verbindingseigenschappen bevat.
Bepaal of de groep bestaat.
- Maak een PrincipalSearchFilter -object met behulp van de constructor.
- Stel het hoofdtype in door het object setPrincipalType van het object PrincipalSearchFilter aan te roepen. Geef de waarde com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP door.
- Stel het domein in door het PrincipalSearchFilter -object setSpecificDomainName van het object aan te roepen. Geef een tekenreekswaarde door die de domeinnaam opgeeft.
- Als u een groep wilt zoeken, roept u de methode findPrincipals van het DirectoryManagerServiceClient -object aan (een principal kan een groep zijn). Geef het PrincipalSearchFilter -object door dat het hoofdtype en de domeinnaam opgeeft. Deze methode retourneert een java.util.List -instantie waarbij elk element een Group -instantie is. Elke groepsinstantie past zich aan het filter aan dat is opgegeven met het object PrincipalSearchFilter .
- Doorloop de instantie java.util.List . 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 de methode setCommonName van het Group -object aan en geeft u een tekenreekswaarde door die de groepsnaam opgeeft.
- Roep de methode setDescription van het object Group aan en geef een tekenreekswaarde door die de beschrijving van de groep aangeeft.
- Roep de methode setDomainName van het object Group aan en geef een tekenreekswaarde door die de domeinnaam opgeeft.
- Roep de methode createLocalGroup van het object DirectoryManagerServiceClient aan en geef de instantie Group door.
De methode createLocalUser retourneert een tekenreekswaarde die de lokale id-waarde van de gebruiker opgeeft.
Voer een handeling uit met de groep.
- Maak een PrincipalSearchFilter -object met behulp van de constructor.
- Stel de waarde van de gebruikersidentificatie in door de methode setUserId van het object PrincipalSearchFilter aan te roepen. Geef een tekenreekswaarde door die de waarde van de gebruikersidentificatie vertegenwoordigt.
- Roep de methode findPrincipals van het object DirectoryManagerServiceClient aan en geef het object PrincipalSearchFilter door. Deze methode retourneert een java.util.List -instantie, waarbij elk element een User -object is. Doorloop de instantie van java.util.List om de gebruiker te zoeken.
- Voeg een gebruiker aan de groep toe door de methode addPrincipalToLocalGroup van het object DirectoryManagerServiceClient aan te roepen. Geef de geretourneerde waarde van de methode getOid van het object User door. Geef de geretourneerde waarde van de methode getOid van de Group -objecten door (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", die een binaire waarde is). Het kenmerk Novell eDirectory "GUID" is bijvoorbeeld geen eenvoudig gegevenstype voor tekenreeksen en werkt daarom niet.

Gebruik "objectsid" voor Active Directory.
Gebruik "nsuniqueid" voor SunOne.

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

omvat projectdossiers

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.

creeer een cliënt DirectoryManagerService

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 gedaan door een DirectoryManagerServiceClient -object te maken. Met de webservice-API wordt dit bereikt door een DirectoryManagerServiceService -object te maken.

Roep de aangewezen gebruiker of groepsverrichtingen aan

Zodra u de de dienstcliënt hebt gecreeerd, kunt u de gebruiker of de verrichtingen van het groepsbeheer dan aanhalen. De de dienstcliënt laat u, domeinen, gebruiker, en groepen toewijzen 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 plaats van deze dossiers, zie Inclusief de bibliotheekdossiers van AEM Forms Java.
Creeer een cliënt DirectoryManagerService.

Maak een DirectoryManagerServiceClient -object door de constructor ervan te gebruiken en een ServiceClientFactory -object door te geven dat verbindingseigenschappen bevat. Voor informatie, zie Plaatsende verbindingseigenschappen.
Roep de juiste gebruikers- of groepsbewerkingen aan.

Als u een gebruiker of groep wilt zoeken, roept u een van de methoden van het object DirectoryManagerServiceClient aan om principes te zoeken (aangezien een principal een gebruiker of een groep kan zijn). In het onderstaande voorbeeld wordt de methode findPrincipals aangeroepen met een zoekfilter (een PrincipalSearchFilter -object).

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

Met het resulterende User - of Group -object (dat beide overerft van de Principal -interface) 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 opgehaald door respectievelijk de methoden getDomainName en getCanonicalName van het Principal -object aan te roepen.

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

Als u een lokale groep wilt verwijderen, roept u de methode deleteLocalGroup van het object DirectoryManagerServiceClient aan 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 het Aanhalen van AEM Forms gebruikend Base64 het coderen.)
- Verwijs naar de Microsoft .NET cliëntassemblage. (Zie Creërend een .NET cliëntassemblage die het coderen Base64gebruikt.)
Creeer een cliënt DirectoryManagerService.

Maak een DirectoryManagerServiceService -object met behulp van 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 methoden van het object DirectoryManagerServiceService aan om principes te zoeken (aangezien een principal een gebruiker of een groep kan zijn). In het onderstaande voorbeeld wordt de methode findPrincipalsWithFilter aangeroepen met een zoekfilter (een PrincipalSearchFilter -object). Wanneer u een PrincipalSearchFilter -object gebruikt, worden lokale hoofdbeginselen alleen geretourneerd als de isLocal -eigenschap is ingesteld op true . Dit gedrag verschilt van wat er zou gebeuren met de Java API.

note note

NOTE

Als het maximale aantal resultaten niet is opgegeven in het zoekfilter (via het 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. Zoekmethoden zoals findGroupMembers leveren ook alleen resultaten op als het maximale aantal resultaten is opgegeven in het zoekfilter (bijvoorbeeld via het GroupMembershipSearchFilter.resultsMax -veld). Dit geldt voor alle zoekfilters die overerven van de klasse GenericSearchFilter . Voor meer informatie, zie AEM Forms API Verwijzing.

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

Met het resulterende User - of Group -object (dat beide overerft van de Principal -interface) 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 opgehaald door respectievelijk de velden domainName en canonicalName van het Principal -object aan te roepen.

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

Als u een lokale groep wilt verwijderen, roept u de methode deleteLocalGroup van het object DirectoryManagerServiceService aan 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, is de a rol 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 douanerollen. De standaardrollen (systeemrollen) zijn reeds ingezetene in AEM Forms. 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.

omvat projectdossiers

creeer een cliënt AuthorizationManagerService

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 gedaan door een AuthorizationManagerServiceClient -object te maken.

voke de aangewezen rol of toestemmingsverrichtingen

Zodra u de de dienstcliënt hebt gecreeerd, kunt u de rol of toestemmingsverrichtingen dan aanhalen. De de dienstcliënt laat u, rollen en toestemmingen toewijzen verwijderen en 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.

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

Als u een rol wilt toewijzen aan een principal, roept u de methode assignRole van het object AuthorizationManagerServiceClient op en geeft u de volgende waarden door:
- Een java.lang.String -object dat de rol-id bevat
- Een array van java.lang.String -objecten met de belangrijkste id's.
Als u een rol wilt verwijderen uit de principal, roept u de methode unassignRole van het object AuthorizationManagerServiceClient op en geeft u de volgende waarden door:
- Een 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. Gebruik de volgende WSDL-definitie: http://localhost:8080/soap/services/AuthorizationManagerService?WSDL&lc_version=9.0.1 .

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

Maak een AuthorizationManagerService-client.
- Maak een AuthorizationManagerServiceClient -object met de standaardconstructor.
- Maak een AuthorizationManagerServiceClient.Endpoint.Address -object met de 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 het attribuut lc_version niet te gebruiken. Dit kenmerk wordt gebruikt wanneer u een serviceverwijzing maakt.
- Maak een System.ServiceModel.BasicHttpBinding -object door de waarde van het AuthorizationManagerServiceClient.Endpoint.Binding -veld op te halen. De geretourneerde waarde wordt gecast naar BasicHttpBinding .
- Stel het veld MessageEncoding van het System.ServiceModel.BasicHttpBinding -object in op 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 AuthorizationManagerServiceClient.ClientCredentials.UserName.UserName toe.
  - Wijs de bijbehorende wachtwoordwaarde toe aan het veld AuthorizationManagerServiceClient.ClientCredentials.UserName.Password .
  - Wijs de constante waarde HttpClientCredentialType.Basic toe aan het veld BasicHttpBindingSecurity.Transport.ClientCredentialType .
  - Wijs de constante waarde BasicHttpSecurityMode.TransportCredentialOnly toe aan het veld BasicHttpBindingSecurity.Security.Mode .
Roep de juiste rol- of machtigingsbewerkingen aan.

Als u een rol wilt toewijzen aan een principal, roept u de methode assignRole van het object AuthorizationManagerServiceClient op en geeft u de volgende waarden door:
- Een string -object dat de rol-id bevat
- Een MyArrayOf_xsd_string -object dat de belangrijkste id's bevat.
Als u een rol wilt verwijderen uit de principal, roept u de methode unassignRole van het object AuthorizationManagerServiceService op en geeft u de volgende waarden door:
- Een 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.

omvat projectdossiers

creeer een cliënt AuthenticationManagerService

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

Roep de authentificatieverrichting aan

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.

wint de authentificatiecontext terug

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 -document te maken en een PDF-document met een wachtwoord te versleutelen. Zorg ervoor dat de gebruiker die is geverifieerd de rol met de naam Services User heeft die nodig 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.

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

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

Roep de methode getContext van het object ServiceClientFactory aan, die een object Context retourneert.

Roep vervolgens de methode initPrincipal van het object Context aan en geef de waarde AuthResult door.

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 het Aanhalen van AEM Forms gebruikend Base64 het coderen.)
- Verwijs naar de Microsoft .NET cliëntassemblage. (Zie "Verwijzend de .NET cliëntassemblage"in het Aanhalen van AEM Forms gebruikend het Coderen Base64.)
Maak een AuthenticationManagerService-client.

Maak een AuthenticationManagerServiceService -object met behulp van de constructor van de proxyklasse.
Roep de verificatiebewerking aan.

Roep de methode authenticate van het object AuthenticationManagerServiceClient aan en geef de volgende waarden door:
- Een string -object dat de naam van de gebruiker bevat
- Een bytearray (een byte[] -object) met het wachtwoord van de gebruiker. U kunt het byte[] -object verkrijgen door een string -object met het wachtwoord om te zetten in een byte[] -array 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 veld authenticatedUser van het object AuthResult te verkrijgen en vervolgens de velden canonicalName en domainName van het resulterende object User .

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 synchronisatie 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

omvat projectdossiers

creeer een UserManagerUtilServiceClientclient

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

specificeer het ondernemingsdomein

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 beleidshulp.)

haalt de synchronisatieverrichting aan

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.

bepaalt als de synchronisatieverrichting volledig is

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.

Maak een UserManagerUtilServiceClient -object door de constructor ervan te gebruiken en een ServiceClientFactory -object door te geven dat verbindingseigenschappen bevat.
Geef het ondernemingsdomein op.
- Roep de methode scheduleSynchronization van het object UserManagerUtilServiceClient aan om de gebruikerssynchronisatie te starten.
- Maak een java.util.Set -instantie met een HashSet -constructor. Zorg ervoor dat u String opgeeft als gegevenstype. Deze Java.util.Set -instantie slaat de domeinnamen op waarop de synchronisatiebewerking van toepassing is.
- Roep voor elke domeinnaam die u wilt toevoegen de methode add van het java.util.Set -object aan en geef de domeinnaam door.
Roep de synchronisatiebewerking aan.

Roep de methode getContext van het object ServiceClientFactory aan, die een object Context retourneert.

Roep vervolgens de methode initPrincipal van het object Context aan en geef de waarde AuthResult door.

zie ook

Gebruikers programmatisch synchroniseren