Activación de la opción de subcliente

uim203
Se puede activar o desactivar el acceso de varios usuarios a los recursos en función de un origen mediante la API de REST (
contact_origins
). Como administrador de MSP, se puede modificar globalmente la asociación origen-usuario de los usuarios nuevos o existentes asignándolos a orígenes específicos para un cliente. De forma predeterminada, cuando se agrega un usuario a una cuenta, no tiene acceso a ningún recurso como, por ejemplo, el visor de alarmas y los cuadros de mandos de la OC, hasta que se active la lista de elementos permitidos de los orígenes que se ha aprovisionado previamente. Se pueden activar varios orígenes para los usuarios de contacto de UIM y para los usuarios de LDAP. Esta función es compatible cuando se activa el indicador
contact_origins_enabled
en la configuración sin formato de sonda de wasp en el concentrador principal y el servidor de la OC (si el servidor de la OC se implementa en un servidor independiente).
Imagínese que es un MSP que vende software a diversos clientes. Como MSP, debe proporcionar el seguro para el software y también el soporte a los clientes con la configuración del software y la realización de varias optimizaciones. Usted (MSP) se convierte en un cliente de CA UIM y sus clientes se vuelven Subclientes. Según la naturaleza de la organización del cliente, (MSP) ofrece diversos servicios como el soporte en línea, el mantenimiento predictivo y la optimización del rendimiento remoto. Es posible ver los datos recopilados para el software mientras están almacenados en el entorno de los clientes. Puede ofrecer varios recursos a los clientes (Subclientes) como Informes de rendimiento, Visualización de alarmas y Cuadros de mandos, entre otros, para optimizar su negocio.
Contenido:
Requisitos previos
Existen los siguientes requisitos:
Activación de la opción de subcliente
Si se activa la opción de subcliente sin asignar los usuarios a uno o más orígenes,
todos
los usuarios recibirán un error al iniciar sesión en el servidor de la OC a menos que los usuarios se asignen a los orígenes o se desactive la función. Para permitir que los usuarios inicien sesión en el servidor de la OC, se
deben
completar todos los pasos en el procedimiento siguiente. Para desactivar la función de subcliente, siga el procedimiento Desactivación de subclientes.
Paso 1: Activación de la función de subcliente
El servidor de la OC y el concentrador principal pueden estar en el mismo servidor. Si la OC y el concentrador principal se implementan en servidores diferentes, realice este procedimiento en ambos servidores.
Siga los pasos siguientes:
  1. En el servidor de la OC, vaya a
    Concentrador
    ,
    Robot
    ,
    Sondas
    y abra la página
    Configuración sin formato
    de la sonda
    wasp
    .
  2. Haga clic en
    setup
    (configuración) para ver las secciones de configuración.
    Raw Configure setup Sections
  3. Seleccione la opción
    Editar valor
    para el parámetro
    contact_origins_enabled
    .
    Edit Value
  4. Defina el valor del parámetro como
    verdadero
    para activar la opción de subcliente y haga clic en
    Actualizar
    .
    Define Parameter Value
  5. Haga clic en
    Actualizar
    en la página
    Configuración sin formato
    para guardar los cambios en el servidor.
  6. Establezca el parámetro
    contact_origins_enabled
    en
    true
    en los demás servidores de la OC y allí donde se implementa el paquete adminconsoleapp.
  7. Reinicie
    wasp
    en todos los servidores que ejecutan la OC y la Consola de administración.
  8. Acceda al cliente de REST y compruebe que los puntos finales de la API aparecen en la lista.
    Por ejemplo, utilice la dirección URL siguiente:
    http://<<hostname>>:<<port>>/uimapi/docs/index.html#/contact_origins
Paso 2: Creación o edición de usuarios
Cree o edite usuarios, asocie los orígenes a las cuentas y defina las listas de control de acceso.
El límite de caracteres para loginName es de 64 caracteres y para origin es de 255 caracteres.
Siga los pasos siguientes:
  1. Como administrador de MSP, inicie sesión en la OC y vaya a
    Configuración
    ->
    Administrador de cuentas
    .
  2. Cree o edite el usuario existente, según sea necesario. Para obtener más información, consulte Adición o modificación de usuarios mediante Administrador de cuentas.
    Add or Modify Users with Account Admin
    Edite los detalles de la cuenta, si es necesario.
    Edit Account Details
    Puesto que no hay ninguna asignación de usuario-origen, se producirá un error durante el inicio de sesión en el servidor de la OC.
Paso 3: Asignación de usuarios a los orígenes
Asigne cada usuario a uno o más orígenes necesarios mediante el cliente de REST.
Siga los pasos siguientes:
  1. Abra al cliente de REST utilizando la siguiente dirección URL:
    http://<<hostname>>:<<port>>/uimapi/docs/index.html#/contact_origins
  2. Para cada usuario o usuarios y mediante la API de POST (addorigins), defina el número de orígenes a los que tiene derecho.
    Por ejemplo, desea agregar los usuarios de contacto acme_user1,
    acme_user2
    , a los orígenes
    win2k12-m-sh03
    y
    win2k12-m-ph_hub
    , defina los parámetros siguientes:
    1. En
      body
      , defina el usuario en el parámetro
      loginName
      y la lista de cuentas en
      origin
      .
      [ { "loginName": "acme_user1", "origin": [ "win2k12-m-sh03","win2k12-m-ph_hub" ] }, { "loginName": "acme_user2", "origin": [ "win2k12-m-sh03", "win2k12-m-ph_hub" ] } ]
    2. En
      Parameter content type
      , seleccione
      application/json
      .
    3. Haga clic en
      Try it out
      (Inténtelo) para ejecutar la consulta.
    4. En
      Response Body
      , verifique que se devuelven los orígenes en la respuesta.
      La respuesta que aparece a continuación indica que para el usuario acme_user1 y acme_user2, la asociación con los orígenes win2k12-m-ph_hub y win2k12-m-sh03 está disponible.
      [ { "loginName": "acme_user1", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03" ] }, { "loginName": "acme_user2", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03", ] } ]
  3. Mediante la API de GET, verifique que los orígenes y los usuarios estén asociados.
    1. En
      loginname
      , defina el ID de usuario. Por ejemplo, defina
      acme_user1
      .
      get_api.png
    2. En
      Response content type
      , seleccione
      application/json
      .
    3. Haga clic en
      Try it out
      (Inténtelo) para ejecutar la consulta.
    4. En
      Response Body
      , verifique que se devuelven los orígenes en la respuesta.
      { "loginName": "acme_user1", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03" ] }
  4. Mediante la API de POST getcontactorigins, verifique que los usuarios y los orígenes estén asociados.
    1. En el
      cuerpo
      , defina los nombres de inicio de sesión. Por ejemplo, defina
      ["acme_user1", "acme_user2"]
      .
      multiple origins.png
    2. En
      Response content type
      , seleccione
      application/json
      .
    3. Haga clic en
      Try it out
      (Inténtelo) para ejecutar la consulta.
    4. En
      Response Body
      , verifique que se devuelven los orígenes en la respuesta.
      [ { "loginName": "acme_user1", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03" ] }, { "loginName": "acme_user2", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03", ] } ]
Paso 4: Verificación de la configuración
Siga los pasos siguientes:
  1. En la OC, vaya a la vista de alarmas y verifique que el usuario (acme_user1) tiene acceso a los orígenes asignados en los pasos anteriores.
Origin Columns where associated Origins are visible
Si la columna Origen no está visible de forma predeterminada, vaya a
Acciones
,
Editar columnas
y, a continuación, seleccione
Origen
.
Funciones compatibles de la API
Nombre de la API
Descripción
POST /contact_origins/addorigins
Devuelve la lista de orígenes para los nombres de inicio de sesión de varios contactos.
DELETE /contact_origins/deletecontactorigins
Elimina la lista de orígenes para los nombres de inicio de sesión de varios contactos.
POST /contact_origins/getcontactorigins
Devuelve la lista de orígenes para los nombres de inicio de sesión de varios contactos.
POST /contact_origins/removeorigins
Elimina la lista de orígenes para los nombres de inicio de sesión del contacto.
POST /contact_origins/setorigins
Establece la lista de orígenes para el nombre de inicio de sesión del contacto.
DELETE /contact_origins/{loginname}
Elimina la lista de orígenes para el nombre de inicio de sesión del contacto.
GET /contact_origins/{loginname}
Devuelve los orígenes del contacto que están configurados para el nombre de inicio de sesión del contacto proporcionado.
Nombre de la API
Dirección URL de la solicitud
Parámetro
Respuesta
POST /contact_origins/addorigins
http://<uim_server>/uimapi/contact_origins/addorigins
nombre de inicio de sesión (especifique el nombre de usuario)
orígenes (especifique la lista de orígenes que debe asociarse con el usuario)
[
{
   "loginName": "acme_user1",
"origen": [
         "win2k12-m-ph_hub", "win2k12-m-sh03"
  ]
},
{
  "loginName": "acme_user2",
"origen": [
       "win2k12-m-ph_hub", "win2k12-m-sh03",
  ]
}
]
DELETE /contact_origins/deletecontactorigins
http://<uim_server>/uimapi/contact_origins/deletecontactorigins
nombre de inicio de sesión (especifique los nombres de usuario para los que desea suprimir los orígenes correspondientes)
Sin contenido
POST /contact_origins/getcontactorigins
http://<uim_server>/uimapi/contact_origins/getcontactorigins
nombre de inicio de sesión (especifique los nombres de usuario para los que desea recuperar los orígenes correspondientes)
[
{
   "loginName": "acme_user1",
"origen": [
         "win2k12-m-ph_hub", "win2k12-m-sh03"
  ]
},
{
  "loginName": "acme_user2",
"origen": [
       "win2k12-m-ph_hub", "win2k12-m-sh03",
  ]
}
]
POST /contact_origins/removeorigins
http://<uim_server>/uimapi/contact_origins/removeorigins
nombre de inicio de sesión (especifique el nombre de usuario para el que desea eliminar los orígenes)
orígenes (especifique la lista de orígenes que desea eliminar para el usuario)
{
"Message": "Success", "ContactOrigins": [ ]
}
{
"Message": "Partial success, Login name does not exist in DB for these contacts",
"ContactOrigins":
[ { "loginName": "acme_user1", "origin": [] },
{ "loginName": "acme_user2", "origin": []
}
]
}
POST /contact_origins/setorigins
http://<uim_server>/uimapi/contact_origins/setorigins
nombre de inicio de sesión (especifique el nombre de usuario)
orígenes (especifique la lista de orígenes que desee establecer para el usuario; esta sustituirá los orígenes establecidos anteriormente)
[
{
   "loginName": "acme_user1",
"origen": [
         "win2k12-m-ph_hub", "win2k12-m-sh03"
  ]
},
{
  "loginName": "acme_user2",
"origen": [
       "win2k12-m-ph_hub",
  ]
}
]
DELETE /contact_origins/{loginname}
http://<uim_server>/uimapi/contact_origins/User1
nombre de inicio de sesión (especifique el nombre de usuario para el que desea suprimir los orígenes correspondientes)
Sin contenido
GET /contact_origins/{loginname}
http://<uim_server>/uimapi/contact_origins/User1
nombre de inicio de sesión (especifique el nombre de usuario para el que desee recuperar los orígenes correspondientes)
{
"loginName": "acme_user1", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03"
]
}
Desactivación de la opción de subcliente
Puede desactivar la opción
contact_origins_enabled
y volver al estado inicial donde los usuarios pueden ver todos los dispositivos y otros recursos asociados a la cuenta. Cuando se desactiva, todos los orígenes por del contacto configurados previamente se borran del sistema. Los datos en la OC para el usuario no se ajustan en función de la asociación de origen correspondiente.
Siga estos pasos:
  1. Como administrador, inicie sesión en la Consola de administración.
  2. Desactive la función de subcliente:
    1. En el servidor de la OC, vaya a
      Concentrador
      ,
      Robot
      ,
      Sondas
      y abra la página
      Configuración sin formato
      de la sonda
      wasp
      .
    2. Haga clic en
      setup
      (configuración) para ver las secciones de configuración.
      Raw Configure setup Sections
    3. Seleccione la opción
      Editar valor
      para el parámetro
      contact_origins_enabled
      .
      Edit Value
    4. Defina el valor del parámetro como
      falso
      para desactivar la opción de subcliente y haga clic en
      Actualizar
      .
      Define Parameter Value
    5. Haga clic en
      Actualizar
      en la página
      Configuración sin formato
      para guardar los cambios en el servidor.
    6. Establezca el parámetro
      contact_origins_enabled
      en
      false
      en el concentrador principal, los demás servidores de la OC y allí donde se implementa el paquete adminconsoleapp.
  3. Reinicie
    wasp
    en todos los servidores de la OC y la Consola de administración.