ユーザーの管理

プロジェクトファイルを含めます。

adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。

DirectoryManagerServices クライアントを作成します。

コンストラクターを使用して接続プロパティを含む ServiceClientFactory オブジェクトを渡すことによって、DirectoryManagerServiceClient オブジェクトを作成します。

ユーザー情報を定義します。

• コンストラクターを使用して UserImpl オブジェクトを作成します。
• UserImpl オブジェクトの setDomainName メソッドを呼び出して、ドメイン名を設定します。ドメイン名を指定する文字列値を渡します。
• UserImpl オブジェクトの setPrincipalType メソッドを呼び出して、プリンシパルタイプを設定します。ユーザーのタイプを指定する文字列値を渡します。例えば、USER を指定できます。
• UserImpl オブジェクトの setUserid メソッドを呼び出して、ユーザー ID の値を設定します。ユーザー識別子の値を指定する文字列値を渡します。例えば、wblue を指定できます。
• UserImpl オブジェクトの setCanonicalName メソッドを呼び出して、正規名を設定します。ユーザーの正規名を指定する文字列値を渡します。例えば、wblue を指定できます。
• UserImpl オブジェクトの setGivenName メソッドを呼び出して、名を設定します。ユーザーの名を指定する文字列値を渡します。例えば、Wendy を指定できます。
• UserImpl オブジェクトの setFamilyName メソッドを呼び出して、姓を設定します。ユーザーの姓を指定する文字列値を渡します。例えば、Blue を指定できます。

メモ

UserImpl オブジェクトに属するメソッドを呼び出して他の値を設定します。例えば、UserImpl オブジェクトの setLocale メソッドを呼び出して、ロケール値を設定できます。

AEM Forms にユーザーを追加します。

DirectoryManagerServiceClient オブジェクトの createLocalUser メソッドを呼び出して、以下の値を渡します。

• 新しいユーザーを表す UserImpl オブジェクト
• ユーザーのパスワードを表す文字列値

この createLocalUser メソッドは、ローカルユーザー ID の値を指定する文字列値を返します。

ユーザーが追加されたことを確認します。

• コンストラクターを使用して PrincipalSearchFilter オブジェクトを作成します。
• PrincipalSearchFilter オブジェクトの setUserId メソッドを呼び出して、ユーザー ID の値を設定します。ユーザー ID の値を表す文字列値を渡します。
• DirectoryManagerServiceClient オブジェクトの findPrincipals メソッドを呼び出し、PrincipalSearchFilter オブジェクトを渡しますこのメソッドは、 java.util.List インスタンス（各要素は User オブジェクト）を返します。java.util.List インスタンスを繰り返し、ユーザーを特定します。

プロジェクトファイルを含めます。

MTOM を使用する Microsoft .NET プロジェクトを作成します。サービス参照に WSDL 定義 http://localhost:8080/soap/services/DirectoryManagerService?WSDL&lc_version=9.0.1 を使用していることを確認してください。

メモ

localhost を、AEM Forms をホストするサーバーの IP アドレスで置換します。

DirectoryManagerService クライアントを作成します。

• デフォルトのコンストラクターを使用して DirectoryManagerServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクタを使用して DirectoryManagerServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を 指定する文字列値を AEM Forms サービスに渡します（例：http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom）。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。?blob=mtom を指定するようにしてください。

• DirectoryManagerServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • DirectoryManagerServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を DirectoryManagerServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。
  • 定数値 BasicHttpSecurityMode.TransportCredentialOnly をフィールド BasicHttpBindingSecurity.Security.Mode に割り当てます。

ユーザー情報を定義します。

• コンストラクターを使用して UserImpl オブジェクトを作成します。
• デフォルト名を設定するには、UserImpl オブジェクトの domainName フィールドに文字列値を割り当てます。
• プリンシパルタイプを設定するには、UserImpl オブジェクトの principalType フィールドに文字列値を割り当てます。例えば、USER を指定できます。
• ユーザー ID の値を設定するには、UserImpl オブジェクトの userid フィールドに文字列値を割り当てます。
• 正規名の値を設定するには、UserImpl オブジェクトの canonicalName フィールドに文字列値を割り当てます。
• 指定された名前の値を設定するには、UserImpl オブジェクトの givenName フィールドに文字列値を割り当てます。
• 姓の値を設定するには、UserImpl オブジェクトの familyName フィールドに文字列値を割り当てます。

AEM Forms にユーザーを追加します。

DirectoryManagerServiceClient オブジェクトの createLocalUser メソッドを呼び出して、以下の値を渡します。

• 新しいユーザーを表す UserImpl オブジェクト
• ユーザーのパスワードを表す文字列値

この createLocalUser メソッドは、ローカルユーザー ID の値を指定する文字列値を返します。

ユーザーが追加されたことを確認します。

• コンストラクターを使用して PrincipalSearchFilter オブジェクトを作成します。
• ユーザー ID の値を設定するには、PrincipalSearchFilter オブジェクトの userId フィールドにユーザー ID の値を表す文字列値を割り当てます。
• DirectoryManagerServiceClient オブジェクトの findPrincipals メソッドを呼び出し、PrincipalSearchFilter オブジェクトを渡しますこのメソッドは、MyArrayOfUser コレクションオブジェクト（各要素は User オブジェクト）を返します。MyArrayOfUser コレクションを反復処理して、ユーザーを特定します。

プロジェクトファイルを含めます。

adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。

DirectoryManagerService クライアントを作成します。

コンストラクタを使用し、接続プロパティを含む ServiceClientFactory オブジェクトを渡すことで、DirectoryManagerServiceClient オブジェクトを作成します。

削除するユーザーを指定します。

• コンストラクタを使用して PrincipalSearchFilter オブジェクトを作成します。
• PrincipalSearchFilter オブジェクトの setUserId メソッドを呼び出して、ユーザー ID の値を設定します。ユーザー ID の値を表す文字列値を渡します。
• DirectoryManagerServiceClient オブジェクトの findPrincipals メソッドを呼び出し、PrincipalSearchFilter オブジェクトを渡しますこのメソッドは、java.util.List インスタンスを返します。このインスタンスの各要素は User オブジェクトです。java.util.List インスタンスを繰り返し、削除するユーザーを特定します。

AEM Forms からユーザーを削除します。

DirectoryManagerServiceClient オブジェクトの deleteLocalUser メソッドを呼び出して、User オブジェクトの oid フィールドの値を渡します。User オブジェクトの getOid メソッドを呼び出します。java.util.List インスタンスから取得した User オブジェクトを使用します。

プロジェクトファイルを含めます。

adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。

DirectoryManagerService クライアントを作成します。

• デフォルトのコンストラクターを使用して DirectoryManagerServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクタを使用して DirectoryManagerServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を 指定する文字列値を AEM Forms サービスに渡します（例：http://localhost:8080/soap/services/DirectoryManagerService?blob=mtom）。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。blob=mtom. を指定してください

• DirectoryManagerServiceClient.Endpoint.Binding フィールドの値を取得して、System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • DirectoryManagerServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を DirectoryManagerServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。
  • 定数値 BasicHttpSecurityMode.TransportCredentialOnly をフィールド BasicHttpBindingSecurity.Security.Mode に割り当てます。

削除するユーザーを指定します。

• コンストラクタを使用して PrincipalSearchFilter オブジェクトを作成します。
• ユーザー ID の値を設定するには、PrincipalSearchFilter オブジェクトの userId フィールドに文字列値を入力します。
• DirectoryManagerServiceClient オブジェクトの findPrincipals メソッドを呼び出し、PrincipalSearchFilter オブジェクトを渡しますこのメソッドは、MyArrayOfUser コレクションオブジェクト（各要素は User オブジェクト）を返します。MyArrayOfUser コレクションを反復処理して、ユーザーを特定します。MyArrayOfUser コレクションオブジェクトから取得した User オブジェクトは、ユーザーの削除に使用されます。

AEM Forms からユーザーを削除します。

ユーザーを削除するには、User オブジェクトの oid フィールド値を DirectoryManagerServiceClient オブジェクトの deleteLocalUser メソッドに渡します。

プロジェクトファイルを含めます。

adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。

DirectoryManagerService クライアントを作成します。

コンストラクターを使用して接続プロパティを含む ServiceClientFactory オブジェクトを渡して、DirectoryManagerServiceClient オブジェクトを作成します。

グループが存在するかどうかを確認します。

• コンストラクターを使用して PrincipalSearchFilter オブジェクトを作成します。
• PrincipalSearchFilter オブジェクトの setPrincipalType オブジェクトを呼び出して、プリンシパルタイプを設定します。値 com.adobe.idp.um.api.infomodel.Principal.PRINCIPALTYPE_GROUP を渡します。
• PrincipalSearchFilter オブジェクトの setSpecificDomainName オブジェクトを呼び出してドメインを設定します。ドメイン名を指定する文字列値を渡します。
• グループを検索するには、DirectoryManagerServiceClient オブジェクトの findPrincipals メソッド（プリンシパルはグループにすることができます）を呼び出します。プリンシパルタイプとドメイン名を指定する PrincipalSearchFilter オブジェクトを渡します。このメソッドは、各要素が Group インスタンスである java.util.List インスタンスを返します。各グループインスタンスは、PrincipalSearchFilter オブジェクトを使用して指定されたフィルターに準拠しています。
• java.util.List インスタンスを反復処理します。各要素について、グループ名を取得します。グループ名が新しいグループ名と等しくないことを確認します。

グループを作成します。

• グループが存在しない場合は、Group オブジェクトの setCommonName メソッドを呼び出して、グループ名を指定する文字列値を渡します。
• Group オブジェクトの setDescription メソッドを呼び出して、グループの説明を指定する文字列値を渡します。
• Group オブジェクトの setDomainName メソッドを呼び出して、ドメイン名を指定する文字列値を渡します。
• DirectoryManagerServiceClient オブジェクトの createLocalGroup メソッドを呼び出して、Group インスタンスを渡します。

createLocalUser メソッドは、ローカルユーザー ID の値を指定する文字列値を返します。

グループでアクションを実行します。

• コンストラクターを使用して PrincipalSearchFilter オブジェクトを作成します。
• PrincipalSearchFilter オブジェクトの setUserId メソッドを呼び出して、ユーザー ID の値を設定します。ユーザー ID の値を表す文字列値を渡します。
• DirectoryManagerServiceClient オブジェクトの findPrincipals メソッドを呼び出し、PrincipalSearchFilter オブジェクトを渡しますこのメソッドは、 java.util.List インスタンス（各要素は User オブジェクト）を返します。java.util.List インスタンスを反復処理して、ユーザーを特定します。
• DirectoryManagerServiceClient オブジェクトの addPrincipalToLocalGroup メソッドを呼び出して、グループにユーザーを追加します。User オブジェクトの getOid メソッドの戻り値を渡します。Group オブジェクトの getOid メソッドの戻り値を渡します（新しいグループを表す Group インスタンスを使用）。

プロジェクトファイルを含めます。

adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。これらのファイルの場所については、AEM Forms Java ライブラリファイルを含めるを参照してください。

DirectoryManagerService クライアントを作成します。

コンストラクターを使用して、接続プロパティを含む ServiceClientFactory オブジェクトを渡すことによって、DirectoryManagerServiceClient オブジェクトを作成します。詳しくは、接続プロパティの設定​を参照してください。

適切なユーザーまたはグループの操作を呼び出します。

ユーザーまたはグループを検索するには、プリンシパルを検索する DirectoryManagerServiceClient オブジェクトのメソッドのいずれかを呼び出します（プリンシパルはユーザーまたはグループにすることができるためです）。次の例では、findPrincipals メソッドは、検索フィルター（PrincipalSearchFilter オブジェクト）を使用して呼び出されています。

この場合の戻り値は Principal オブジェクトを含む java.util.List であるため、結果を反復処理し、Principalオブジェクトを User オブジェクトまたは Group オブジェクトにキャストします。

結果の User オブジェクトまたは Group オブジェクト（両方とも Principal インターフェイスから継承）を使用して、ワークフローで必要な情報を取得します。例えば、ドメイン名と正規名の値を組み合わせて、プリンシパルを一意に識別します。これらはそれぞれ Principal オブジェクトの getDomainName メソッドおよび getCanonicalName メソッドを呼び出して取得されます。

ローカルユーザーを削除するには、DirectoryManagerServiceClient オブジェクトの deleteLocalUser メソッドを呼び出してユーザーの識別情報を渡します。

ローカルグループを削除するには、DirectoryManagerServiceClient オブジェクトの deleteLocalGroup メソッドを呼び出してグループの識別情報を渡します。

プロジェクトファイルを含めます。

• Directory Manager WSDL を使用するMicrosoft .NET クライアントアセンブリを作成します（Base64 エンコーディングを使用したAEM Forms の呼び出しを参照してください）。
• Microsoft .NET クライアントアセンブリを参照します（Base64 エンコーディングを使用する .NET クライアントアセンブリの作成を参照してください）。

DirectoryManagerService クライアントを作成します。

プロキシクラスのコンストラクターを使用して、DirectoryManagerServiceService オブジェクトを作成します。

適切なユーザーまたはグループの操作を呼び出します。

ユーザーまたはグループを検索するには、プリンシパルを検索する DirectoryManagerServiceService オブジェクトのメソッドのいずれかを呼び出します（プリンシパルはユーザーまたはグループにすることができるためです）。次の例では、findPrincipalsWithFilter メソッドは、検索フィルター（PrincipalSearchFilter オブジェクト）を使用して呼び出されます。PrincipalSearchFilter オブジェクトを使用する場合、ローカルプリンシパルは、isLocal プロパティが true に設定されている場合のみに返されます。この動作は、Java API で発生する動作とは異なります。

メモ

検索フィルターで結果の最大数が PrincipalSearchFilter.resultsMax フィールドを介して指定されていない場合、最大 1000 個の結果が返されます。これは、Java API を使用して発生する動作とは異なります。Java API では、結果の数はデフォルトで最大 10 個です。また、findGroupMembers などの検索メソッドでは、検索フィルターで（たとえば、GroupMembershipSearchFilter.resultsMax フィールドで）結果の最大数が指定されていない場合、結果は得られません。これは、GenericSearchFilter クラスから継承されるすべての検索フィルターに適用されます。詳しくは、「AEM Forms API リフェレンス」を参照してください。

この場合の戻り値は Principal オブジェクトを含む object[] であるため、結果を反復処理して Principal オブジェクトを User または Group オブジェクトにキャストします。

結果の User オブジェクトまたは Group オブジェクト（両方とも Principal インターフェイス から継承）を使用して、ワークフローで必要な情報を取得します。例えば、ドメイン名と正規名の値を組み合わせて、プリンシパルを一意に識別します。これらはそれぞれ、Principal オブジェクトの domainName フィールドおよび canonicalName フィールドを呼び出すことによって設定されます。

ローカルユーザーを削除するには、DirectoryManagerServiceService オブジェクトの deleteLocalUser メソッドを呼び出してユーザーの識別情報を渡します。

ローカルグループを削除するには、DirectoryManagerServiceService オブジェクトの deleteLocalGroup メソッドを呼び出してグループの識別情報を渡します。

プロジェクトファイルを含めます。

adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。

AuthorizationManagerService クライアントを作成します。

コンストラクターを使用し、接続プロパティを含む ServiceClientFactory オブジェクトを渡すことにより、AuthorizationManagerServiceClient オブジェクトを作成します。

適切な役割または権限の操作を呼び出します。

プリンシパルに役割を割り当てるには、AuthorizationManagerServiceClient オブジェクトの assignRole メソッドを呼び出して、次の値を渡します。

• 役割識別情報を含む java.lang.String オブジェクト
• プリンシパル識別情報を含む java.lang.String オブジェクトの配列。

プリンシパルから役割を削除するには、AuthorizationManagerServiceClient オブジェクトの unassignRole メソッドを呼び出して、次の値を渡します。

• 役割識別情報を含む java.lang.String オブジェクト。
• プリンシパル識別情報を含む java.lang.String オブジェクトの配列。

プロジェクトファイルを含めます。

MTOM を使用する Microsoft .NET プロジェクトを作成します。WSDL 定義 http://localhost:8080/soap/services/AuthorizationManagerService?WSDL&lc_version=9.0.1 を使用するようにします。

NOTE

localhost を、AEM Forms をホストするサーバーの IP アドレスと置き換えます。

AuthorizationManagerService クライアントを作成します。

• デフォルトのコンストラクターを使用して AuthorizationManagerServiceClient オブジェクトを作成します。

• System.ServiceModel.EndpointAddress コンストラクタを使用して、AuthorizationManagerServiceClient.Endpoint.Address オブジェクトを作成します。WSDL を指定する文字列値を AEM Forms サービスに渡します（例：http://localhost:8080/soap/services/AuthorizationManagerService?blob=mtom）。lc_version 属性を使用する必要はありません。この属性は、サービス参照を作成する際に使用されます。

• AuthorizationManagerServiceClient.Endpoint.Binding フィールドの値を取得して System.ServiceModel.BasicHttpBinding オブジェクトを作成します。戻り値を BasicHttpBinding にキャストします。

• System.ServiceModel.BasicHttpBinding オブジェクトの MessageEncoding フィールドを WSMessageEncoding.Mtom に設定します。この値により、MTOM が確実に使用されます。

• 次のタスクを実行して、HTTP 基本認証を有効にします。

  • AuthorizationManagerServiceClient.ClientCredentials.UserName.UserName フィールドに AEM Forms ユーザー名を割り当てます。
  • 対応するパスワード値を AuthorizationManagerServiceClient.ClientCredentials.UserName.Password フィールドに割り当てます。
  • 定数値 HttpClientCredentialType.Basic をBasicHttpBindingSecurity.Transport.ClientCredentialType フィールドに割り当てます。
  • 定数値 BasicHttpSecurityMode.TransportCredentialOnly を BasicHttpBindingSecurity.Security.Mode フィールドに割り当てます。

適切な役割または権限の操作を呼び出します。

プリンシパルに役割を割り当てるには、AuthorizationManagerServiceClient オブジェクトの assignRole メソッドを呼び出して、次の値を渡します。

• 役割識別情報を含む string オブジェクト
• プリンシパル識別情報を含む MyArrayOf_xsd_string オブジェクト

プリンシパルから役割を削除するには、AuthorizationManagerServiceService オブジェクトの unassignRole メソッドを呼び出して、以下の値を渡します。

• 役割識別情報を含む string オブジェクト。
• プリンシパル識別情報を含む string オブジェクトの配列。

プロジェクトファイルを含めます。

adobe-livecycle-client.jar などのクライアント JAR ファイルを Java プロジェクトのクラスパスに含めます。

AuthenticationManagerServices クライアントを作成します。

AuthenticationManagerServiceClient オブジェクトを作成するには、コンストラクターを使用し、接続プロパティを含む ServiceClientFactory オブジェクトを渡します。

認証操作を呼び出します。

AuthenticationManagerServiceClient オブジェクトの authenticate メソッドを呼び出して、以下の値を渡します。

• ユーザーの名前を含む java.lang.String オブジェクト。
• ユーザーのパスワードを含むバイト配列（byte[] オブジェクト）。java.lang.String オブジェクトの getBytes メソッドを呼び出すと、byte[] オブジェクトを取得できます。

認証メソッドが、認証済みユーザーに関する情報を含む AuthResult オブジェクトを返します。

認証コンテキストを取得します。

ServiceClientFactory オブジェクトの getContext メソッドを呼び出すことで、Context オブジェクトが返されます。

Context オブジェクトの initPrincipal メソッドを呼び出し、AuthResult を渡します。

プロジェクトファイルを含めます。

• Authentication Manager WSDL を使用する Microsoft .NET クライアントアセンブリを作成します（Base64 エンコーディングを使用した AEM Forms の呼び出しを参照してください）。
• Microsoft .NET クライアントアセンブリを参照します（Base64 エンコーディングを使用した AEM Forms の呼び出しの「.NET クライアントアセンブリの参照」を参照してください）。

AuthenticationManagerService クライアントを作成します。

プロキシクラスのコンストラクターを使用して、AuthenticationManagerServiceService オブジェクトを作成します。

認証操作を呼び出します。

AuthenticationManagerServiceClient オブジェクトの authenticate メソッドを呼び出して、以下の値を渡します。

• ユーザーの名前を含む string オブジェクト
• ユーザーのパスワードを含むバイト配列（byte[] オブジェクト）。以下の例に示すロジックを使用して、パスワードを含む string オブジェクトを byte[] 配列に変換することによって、byte[] オブジェクトを取得できます。
• 戻り値は AuthResult オブジェクトです。このオブジェクトは、ユーザーに関する情報を取得するために使用できます。以下の例では、ユーザーの情報は、最初に AuthResult オブジェクトの authenticatedUser フィールドを取得し、続いてその結果の User オブジェクトの canonicalName フィールドおよび domainName フィールドを取得することによって取得されます。