CreateUserLDAPAuthenticated

説明

LDAP 認証が指定された ClearQuest® ユーザー アカウントを作成します。新規ユーザー アカウント AuthenticationMode を LDAP_AUTHENTICATION として設定します。

このメソッドは次の 2 つの引数を使用します。
  • LDAP ユーザーのログイン名 (LDAP_login_name)
  • A Rational® ClearQuest ユーザーのプロファイル名 (CQ_user_name)

CreateUserLDAPAuthenticated メソッドは、LDAP 属性値を LDAP ユーザー アカウントから ClearQuest ユーザー プロファイル フィールドにコピーして、LDAP ユーザー名を Rational ClearQuest ユーザー名にマップします。

このメソッドは最初にスキーマ リポジトリを検査し、別のアクティブ LDAP によって有効にされたユーザーの CQLDAPMap フィールド値と競合しないことを確認して、アクティブ LDAP によって有効にされたユーザー全体で値が固有であるようにします。
注: LDAP ユーザー レコードと ClearQuest ユーザー レコードとの相関に使用される Rational ClearQuest ユーザー プロファイル フィールドは、CQLDAPMap フィールドです。

CQ_LOGIN_NAME がマッピング フィールドとして構成されている場合 (installutil setcqldapmap サブコマンドを使用して、LDAP と ClearQuest ユーザー アカウントとの相関に使用する Rational ClearQuest ユーザー プロファイル フィールドを指定)、CQ_user_name パラメータは LDAP_login_name と同一か、または NULL 文字列に設定されている必要があります。

注: このメソッドの呼び出し側にはこのメソッドを呼び出すための管理者権限が必要です (つまり、UserPrivilegeMaskType 値が USER_ADMIN)。
次の場合には、エラーが発生します。
  • メソッドの呼び出し側に、この操作を実行する管理者権限がない。
  • LDAP ユーザー アカウント (LDAP_login_name) が見つからない。
  • 同じ名前の競合する Rational ClearQuest ユーザー アカウント (CQ_user_name) がある。
  • Rational ClearQuest ユーザーへの LDAP のマップに使用される LDAP 属性の値が取得されない。
  • CQ_LOGIN_NAME がマッピング フィールドとして構成されているが、CQ_user_name パラメータが LDAP_login_name と同一でないか、または NULL 文字列が設定されている。
  • CQLDAPMap フィールドに配置される LDAP 属性が、既存の、有効化された LDAP CQLDAPMap フィールド値と競合する。
注: このメソッドは、バージョン 2003.06.14 で使用可能になります。

構文

VBScript

adminSession.CreateUserLDAPAuthenticated(LDAP_login_name, CQ_user_name) 

Perl

$adminSession->CreateUserLDAPAuthenticated(LDAP_login_name, CQ_user_name); 
識別子
説明
adminSession
AdminSession オブジェクトは、現在のスキーマ リポジトリのアクセス セッションを表します。
LDAP_login_name
LDAP 認証のユーザーのログイン名を含む String (例えば、myUniqueName@ibm.com)。
CQ_user_name
ClearQuest データベースに保存される Rational ClearQuest ユーザー プロファイル名を含む String。 既存の ClearQuest ユーザー アカウント名と一致していてはなりません。
戻り値
成功の場合はなし、それ以外の場合は例外。

VBScript

' Create a Rational ClearQuest admin session
set adminSession = CreateObject("ClearQuest.AdminSession")
' Logon as admin
adminSession.Logon "admin", "admin", ""
' Create an LDAP authenticated user
Dim cquser2 ' a user object
Dim ldap_login
Dim cq_username
Dim mode
' the user authentication mode
ldap_login = "myusername@us.ibm.com"
cq_username = "myusername"
StdOut "Creating LDAP authenticated user " & ldap_name & vbCrLf
Set cquser2 = admin_session.CreateUserLDAPAuthenticated(ldap_login, cq_username)
' verify the user authentication mode:
StdOut "Getting authentication mode for user " & cquser2.name & vbCrLf
mode = cquser2.GetAuthenticationMode
StdOut "user mode: " & CStr(mode) & vbCrLf 

Perl

use CQPerlExt;
# Create a Rational ClearQuest admin session
$adminSession= CQAdminSession::Build();
#Logon as admin
$adminSession->Logon( "admin", "admin", "" );
my $ldap_login = "myusername@us.ibm.com";
my $cq_username = "myusername";
my $newUserObj;
$newUserObj = $adminSession->CreateUserLDAPAuthenticated($ldap_login, $cq_username);
# ... 
CQAdminSession::Unbuild($adminSession);

フィードバック