Descripción
Crea una cuenta de usuario de Rational ClearQuest con autenticación LDAP.
Establece la AuthenticationMode de la nueva cuenta de usuario como LDAP_AUTHENTICATION.
Este método toma dos argumentos:
- Un nombre de inicio de sesión de usuario para LDAP (LDAP_login_name)
- Un nombre del perfil de usuario de Rational ClearQuest
(CQ_user_name)
El método CreateUserLDAPAuthenticated copia un valor de atributo LDAP de la cuenta de usuario de LDAP en el campo del perfil de usuario de ClearQuest para correlacionar un nombre de usuario de
LDAP con un nombre de usuario de Rational ClearQuest.
El primer método comprueba el repositorio de esquemas para garantizar que no existen conflictos con los valores de campo
CQLDAPMap de los demás usuarios habilitados para LDAP activos a fin de asegurarse de que los valores son exclusivos a través de los usuarios habilitados de LDAP activos.
Nota: El campo de perfil de usuario de
Rational ClearQuest que se utiliza para correlacionar registros de usuario de LDAP con registros de usuario de ClearQuest es el campo
CQLDAPMap.
Si CQ_LOGIN_NAME se configura como archivo de correlación (utilizando el submandato installutil setcqldapmap para especificar qué campo de perfil de usuario de Rational ClearQuest se utiliza para correlacionar LDAP con las cuentas de usuario de ClearQuest), el parámetro CQ_user_name debe ser idéntico a LDAP_login_name o estar establecido en una serie Null.
Nota: El llamador de este método debe utilizar privilegios de administrador para llamar a este método (es decir, el valor UserPrivilegeMaskType, USER_ADMIN).
Se producen errores si:
- El llamador del método no tiene privilegios de administrador para llevar a cabo la operación
- No se encuentra la cuenta de usuario de LDAP (LDAP_login_name)
- Existe una cuenta de usuario de Rational ClearQuest en conflicto (CQ_user_name) con el mismo nombre
- No se recupera el valor del atributo LDAP que se utiliza para correlacionar un usuario LDAP con un usuario
Rational ClearQuest
- CQ_LOGIN_NAME se configura como archivo de correlación, pero el parámetro
CQ_user_name no es idéntico al LDAP_login_name o se ha establecido en una serie Null.
- El atributo LDAP que se va a situar en el campo CQLDAPMap está en conflicto con un valor de campo CQLDAPMap habilitado de LDAP existente.
Nota: Este método estuvo disponible en la versión de 2003.06.14.
Sintaxis
VBScript
adminSession.CreateUserLDAPAuthenticated(LDAP_login_name, CQ_user_name)
Perl
$adminSession->CreateUserLDAPAuthenticated(LDAP_login_name, CQ_user_name);
- Identificador
- Descripción
- adminSession
- Objeto AdminSession que representa la sesión de acceso al repositorio de esquemas actual.
- LDAP_login_name
- Un valor String que contiene el nombre de inicio de sesión de usuario para la autenticación LDAP (por ejemplo, myUniqueName@ibm.com).
- CQ_user_name
- Un valor String que contiene el nombre del perfil de usuario de
Rational ClearQuest que se
va a almacenar en la base de datos de
ClearQuest. No debe coincidir con ningún nombre de cuenta de usuario de
ClearQuest
existente.
- Valor de retorno
- Ninguno si es satisfactorio, de otro modo, una excepción.
Ejemplos
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);