Ativar a sublocação

uim203
Você pode ativar ou desativar o acesso para vários usuários a recursos com base em uma origem usando APIs REST (
contact_origins
). Como administrador do MSP, você pode modificar globalmente a associação de origem de usuários novos ou existentes mapeando-os para origens específicas de um Inquilino. Por padrão, quando um usuário for adicionado a uma conta, ele não terá acesso a nenhum recurso, como o Visualizador de alarmes ou os Painéis do OC, até que você ative para ele a lista branca pré-provisionada das origens. É possível ativar várias origens para vários usuários de contato do UIM e usuários LDAP. Esse recurso é suportado quando você ativa o sinalizador
contact_origins_enabled
na configuração de dados brutos do probe wasp no hub principal e no OC (se o OC estiver implantado em um servidor separado).
Imagine que você é um MSP vendendo software para vários clientes. Como MSP, você fornece garantia para o software e também oferece suporte a seus clientes com a configuração do software e realização de várias otimizações. Você (MSP) se torna cliente do CA UIM e seus clientes se tornam subinquilinos. Com base na natureza da empresa do cliente, você (MSP) oferece diversos serviços, como o suporte online, a manutenção preditiva e a otimização do desempenho remoto. Você poderá exibir os dados coletados para o software enquanto eles residirem no ambiente do cliente. Você pode oferecer vários recursos aos clientes (subinquilinos) como relatórios de desempenho, exibição de alarmes e painéis, entre outros, para otimizar seus negócios.
Conteúdo:
Pré-requisitos
Veja abaixo os requisitos necessários:
  • CA UIM 9.0.2 (ou posterior)
  • Implante o pacote uimapi-20.3 no robô do hub principal no ambiente do CA UIM 20.3.0. Para obter mais informações, consulte Implantar o pacote uimapi.
    Não implante o pacote em robôs do CABI.
  • Verifique se os privilégios de administração da conta estão disponíveis ao usuário para atualizar as origens para os usuários.
  • Crie ou identifique os usuários que deseja mapear para origens específicas. Para obter mais informações, consulte Adicionar ou modificar usuários com Administração de contas.
  • Certifique-se de que a instalação do LDAP esteja disponível se estiver mapeando os usuários LDAP para uma origem.Para obter mais informações, consulte Adicionar ou modificar usuários com Administração de contas.
Ativar a sublocação
Se você ativar a sublocação sem mapear os usuários para uma ou mais origens,
todos
os usuários terão problemas ao efetuar logon no servidor do OC, a menos que eles sejam mapeados para as origens ou que você desative o recurso. Para permitir que os usuários efetuem logon no servidor do OC, você
deve
concluir todas as etapas descritas no procedimento abaixo. Para desativar a sublocação, siga o procedimento Desativar sublocação.
Etapa 1: ativar o recurso de sublocação
O servidor do OC e o hub principal podem estar no mesmo servidor. Se o OC e o hub principal estiverem implantados em servidores diferentes, execute esse procedimento em ambos os servidores.
Siga estas etapas:
  1. No servidor do OC, vá para
    Hub
    ,
    Robô
    ,
    Probes
    e abra a página
    Configuração de dados brutos
    do probe
    wasp
    .
  2. Selecione
    Configuração
    para exibir as seções de configuração.
    Raw Configure setup Sections
  3. Selecione a opção
    Editar valor
    para o parâmetro
    contact_origins_enabled
    .
    Edit Value
  4. Defina o valor do parâmetro como
    true
    para ativar a opção de sublocação e selecione
    ATUALIZAR
    .
    Define Parameter Value
  5. Selecione
    ATUALIZAR
    na página
    Configuração de dados brutos
    para salvar as alterações no servidor.
  6. Defina o parâmetro
    contact_origins_enabled
    como
    true
    nos servidores restantes do OC e onde quer que o pacote adminconsoleapp esteja implantado.
  7. Reinicie o
    wasp
    em todos os servidores que estão executando o OC e o Console de administração.
  8. Acesse o cliente REST e verifique se os terminais da API aparecem na lista.
    Por exemplo, use o seguinte URL:
    http://<<hostname>>:<<port>>/uimapi/docs/index.html#/contact_origins
Etapa 2: criar ou editar usuários
Crie ou edite usuários, associe as origens às contas e defina as ACLs.
O limite de caracteres para loginName é de 64 e para origin é de 255 caracteres.
Siga estas etapas:
  1. Como administrador do MSP, efetue logon no OC e vá para
    Configurações
    ->
    Admin da conta
    .
  2. Crie ou edite o usuário existente, conforme a necessidade. Para obter mais informações, consulte Adicionar ou modificar usuários com Administração de contas.
    Add or Modify Users with Account Admin
    Edite os detalhes da conta, se necessário.
    Edit Account Details
    Como não há mapeamento entre a origem e o usuário, o logon no servidor do OC apresentará falha.
Etapa 3: mapear usuários para origens
Mapeie os usuários para uma ou mais origens necessárias usando o cliente REST.
Siga estas etapas:
  1. Abra o cliente REST usando o seguinte URL:
    http://<<hostname>>:<<port>>/uimapi/docs/index.html#/contact_origins
  2. Para os usuários que estejam usando a API POST (addorigins), defina o número de origens para as quais estão qualificados.
    Por exemplo, se você deseja adicionar os usuários de contato acme_user1 e
    acme_user2
    às origens
    win2k12-m-sh03
    e
    win2k12-m-ph_hub
    , defina os seguintes parâmetros:
    1. No
      corpo
      , defina o usuário no parâmetro
      loginName
      e a lista de contas na
      origem
      .
      [ { "loginName": "acme_user1", "origin": [ "win2k12-m-sh03","win2k12-m-ph_hub" ] }, { "loginName": "acme_user2", "origin": [ "win2k12-m-sh03", "win2k12-m-ph_hub" ] } ]
    2. Em
      Parameter content type
      , selecione
      application/json.
    3. Selecione
      Try it out
      para executar a consulta.
    4. No
      Corpo da resposta
      , verifique se as origens são retornadas na resposta.
      A resposta a seguir indica que para o usuário acme_user1 e acme_user2, a associação às origens win2k12-m-ph_hub e win2k12-m-sh03 está disponível.
      [ { "loginName": "acme_user1", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03" ] }, { "loginName": "acme_user2", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03", ] } ]
  3. Usando a API GET, verifique se os usuários e as origens estão associados.
    1. Em
      loginname
      , defina userID. Por exemplo, defina
      acme_user1
      .
      get_api.png
    2. Em
      Parameter content type
      , selecione
      application/json
      .
    3. Selecione
      Try it out
      para executar a consulta.
    4. No
      Corpo da resposta
      , verifique se as origens são retornadas na resposta.
      { "loginName": "acme_user1", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03" ] }
  4. Usando a API POST getcontactorigins, verifique se os usuários e as origens estão associados.
    1. No
      corpo
      , defina os nomes de logon. Por exemplo, defina
      ["acme_user1", "acme_user2"].
      multiple origins.png
    2. Em
      Parameter content type
      , selecione
      application/json
      .
    3. Selecione
      Try it out
      para executar a consulta.
    4. No
      Corpo da resposta
      , verifique se as origens são retornadas na resposta.
      [ { "loginName": "acme_user1", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03" ] }, { "loginName": "acme_user2", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03", ] } ]
Etapa 4: verificar a configuração
Siga estas etapas:
  1. No OC, vá para a exibição Alarmes e verifique se o usuário (acme_user1) tem acesso às origens para as quais ele foi mapeado nas etapas acima.
Origin Columns where associated Origins are visible
Se a coluna Origem não estiver visível por padrão, vá para
Ações
,
Editar colunas
e selecione
Origem
.
Funções de API suportadas
Nome da API
Descrição
POST /contact_origins/addorigins
Adicione a lista de origens para vários nomes de logon do contato.
DELETE /contact_origins/deletecontactorigins
Remove a lista de origens para vários nomes de logon do contato.
POST /contact_origins/getcontactorigins
Retorna uma lista de origens para vários nomes de logon de contato.
POST /contact_origins/removeorigins
Remove a lista de origens para o nome de logon do contato.
POST /contact_origins/setorigins
Define a lista de origens para o nome de logon do contato.
DELETE /contact_origins/{loginname}
Remove a lista de origens para o nome de logon do contato.
GET /contact_origins/{loginname}
Retorna as origens do contato que são configuradas para o nome de logon do contato fornecido.
Nome da API
URL de solicitação
Parâmetro
Resposta
POST /contact_origins/addorigins
http://<uim_server>/uimapi/contact_origins/addorigins
nome de logon (especifica o nome de usuário)
origins (especifica a lista de origens para associar ao usuário)
[
{
   "loginName": "acme_user1",
"origin": [
         "win2k12-m-ph_hub", "win2k12-m-sh03"
  ]
},
{
  "loginName": "acme_user2",
"origin": [
       "win2k12-m-ph_hub", "win2k12-m-sh03",
  ]
}
]
DELETE /contact_origins/deletecontactorigins
http://<uim_server>/uimapi/contact_origins/deletecontactorigins
loginname (especifica o nome de usuário para o qual deseja excluir as origens correspondentes)
Sem conteúdo
POST /contact_origins/getcontactorigins
http://<uim_server>/uimapi/contact_origins/getcontactorigins
loginname (especifica nomes de usuário para o qual deseja recuperar as origens correspondentes)
[
{
   "loginName": "acme_user1",
"origin": [
         "win2k12-m-ph_hub", "win2k12-m-sh03"
  ]
},
{
  "loginName": "acme_user2",
"origin": [
       "win2k12-m-ph_hub", "win2k12-m-sh03",
  ]
}
]
POST /contact_origins/removeorigins
http://<uim_server>/uimapi/contact_origins/removeorigins
loginname (especifica o nome de usuário para o qual deseja remover as origens)
origins (especifica a lista de origens que deseja remover do usuário)
{
"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
nome de logon (especifica o nome de usuário)
origins (especifica a lista de origens que deseja definir para o usuário; isso substitui qualquer origem definida anteriormente)
[
{
   "loginName": "acme_user1",
"origin": [
         "win2k12-m-ph_hub", "win2k12-m-sh03"
  ]
},
{
  "loginName": "acme_user2",
"origin": [
       "win2k12-m-ph_hub",
  ]
}
]
DELETE /contact_origins/{loginname}
http://<uim_server>/uimapi/contact_origins/User1
loginname (especifica o nome de usuário para o qual deseja excluir as origens correspondentes)
Sem conteúdo
GET /contact_origins/{loginname}
http://<uim_server>/uimapi/contact_origins/User1
loginname (especifica o nome de usuário para o qual deseja recuperar as origens correspondentes)
{
"loginName": "acme_user1", "origin": [ "win2k12-m-ph_hub", "win2k12-m-sh03"
]
}
Desativar sublocação
Você pode desativar a opção
contact_origins_enabled
e reverter para o estado inicial em que os usuários podem exibir todos os dispositivos e outros recursos associados à conta. Quando você desativa a opção, todas as origens do contato configuradas anteriormente são removidas do sistema. Os dados do usuário no OC não serão aceitos com base na associação de origem correspondente.
Siga as etapas a seguir:
  1. Como administrador, efetue logon no Console de administração.
  2. Desative o recurso de sublocação:
    1. No servidor do OC, vá para
      Hub
      ,
      Robô
      ,
      Probes
      e abra a página
      Configuração de dados brutos
      do probe
      wasp
      .
    2. Selecione
      Configuração
      para exibir as seções de configuração.
      Raw Configure setup Sections
    3. Selecione a opção
      Editar valor
      para o parâmetro
      contact_origins_enabled
      .
      Edit Value
    4. Defina o valor do parâmetro como
      false
      para desativar a opção de sublocação e selecione
      ATUALIZAR
      .
      Define Parameter Value
    5. Selecione
      ATUALIZAR
      na página
      Configuração de dados brutos
      para salvar as alterações no servidor.
    6. Defina o parâmetro
      contact_origins_enabled
      como
      false
      no hub principal, nos demais servidores do OC e onde quer que o pacote adminconsoleapp esteja implantado.
  3. Reinicie o
    wasp
    em todos os servidores do OC e no Console de administração.