CreateUserLDAPAuthenticated

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 del 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 se configura CQ_LOGIN_NAME como campo de correlación (por medio del submandato installutil setcqldapmap para especificar el campo de perfil de usuario de Rational ClearQuest que se debe utilizar para correlacionar cuentas de usuario de LDAP y ClearQuest), el parámetro CQ_user_name debe ser idéntico al LDAP_login_name o se debe establecer 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);

Comentarios