Você gerencia seu perfil nas configurações da sua conta do Omnissa Connect. No seu perfil, você pode selecionar configurações de segurança e gerar e gerenciar tokens de API. Você também pode visualizar as funções que ocupa na sua organização.
Como visualizar meu perfil
Para acessar sua conta no Omnissa Connect, selecione o item de menu Configurações da Conta na página Início do Omnissa Connect. Seu perfil consiste nos detalhes que você forneceu quando criou sua conta do Omnissa.
Observação: você não pode alterar o endereço de e-mail com o qual se registrou.

Observação: para obter detalhes sobre como vincular sua conta federada à sua conta da Omnissa, consulte Contas Federadas, Contas da Omnissa e Como Vinculá-las.
Como gerar tokens de API
Você usa tokens de API para se autenticar ao fazer conexões de API autorizadas. Um token de API é trocado por um token de acesso e autoriza o acesso por organização. Você pode gerar tokens de API na página da sua conta no Omnissa Connect.
Escopos de token
Os tokens são gerados usando um algoritmo especial que seleciona caracteres alfanuméricos. Cada token é uma combinação única de 65 caracteres. Ao gerar um token, você determina sua duração e escopos.
- O Tempo de Vida (TTL) de um token pode variar de vários minutos a vários meses ou pode ser definida para nunca expirar. A duração padrão é de seis meses.
- Os escopos oferecem uma maneira de implementar controles sobre quais áreas em uma organização o seu token pode acessar – especificamente, qual função em uma organização, quais serviços e o nível de permissões.
Pré-requisitos
Tenha um local de armazenamento seguro e protegido para seus tokens de API.
Procedimento
Notas:
- O token que não expira pode ser um risco de segurança, se comprometido. Se estiver comprometido, revogue o token.
- Mesmo que você atribua o acesso a Todas as Funções ao seu token, ele terá apenas as funções de acesso compatíveis com a sua conta.
- Se você precisar das funções de Organização ou Serviço atribuídas a você, use a guia Minhas Funções na página Configuração da Conta.
- Na navegação à esquerda do Omnissa Connect, selecione Configurações da Conta > Tokens de API.
- Selecione o link Gerar um Novo Token de API.
- Digite um nome para o token.
- Especifique o tempo de vida útil desejado do token no campo de texto TTL do Token.
- Defina escopos para o token. Sua seleção deve ser baseada nas funções suportadas pela sua conta. Se necessário, você pode selecionar Todas as Funções e dar acesso via token a todas as funções de Organização e de Serviço.
| Escopo | Descrição |
|---|---|
| Funções da organização | As funções da organização determinam o acesso de um usuário aos recursos da organização. Selecione uma ou mais funções da organização para o token de API. |
| Funções do serviço | As funções de serviço são integradas em conjuntos predefinidos de permissões que concedem acesso a assinaturas do serviço da Omnissa. Use o ícone de seta ao lado de um nome de serviço para expandir as funções disponíveis para esse serviço e, em seguida, selecione uma ou mais funções de serviço para o seu token de API. |
| Permissões | Alguns serviços permitem que você faça uma seleção mais detalhada atribuindo um conjunto limitado das permissões disponíveis para uma função de serviço. Quando você seleciona uma função de Serviço, as permissões disponíveis são exibidas no lado direito da tabela. Selecione as permissões de Serviço relevantes para o seu token de API. |
- (Opcional) Marque a caixa de seleção OpenID para recuperar um token compatível com o OpenID com detalhes estendidos do usuário.
- (Opcional) Defina uma preferência de e-mail para receber um lembrete quando o token estiver prestes a expirar.
- Selecione Gerar.
- Salve as credenciais do token em um lugar seguro para que você possa recuperá-las para uso futuro.
Por motivos de segurança, depois de gerar o token, o Omnissa Connect exibe apenas o nome do token na guia Tokens de API e não as credenciais do token. Você não pode mais reutilizar o token copiando as credenciais dessa página. - Clique em Continuar.
Exemplo: usar um token de API para interagir com APIs do Omnissa Connect
Você pode usar um token de API para interagir com nossas APIs trocando-o por um token de autenticação.
- Gerar um token de API.
- Execute o POST para https://connect.omnissa.com/csp/gateway/am/api/auth/api-tokens/authorize.
- No cabeçalho, inclua as seguintes solicitações:
- aceitar:
application/json - tipo de conteúdo:
application/x-www-form-urlencoded/
- aceitar:
- No corpo, inclua a solicitação
refresh_token={token value}. - Use o token de autenticação no cabeçalho do
csp-auth-tokennas chamadas HTTP do script.
Como gerenciar meus tokens de API
Como único proprietário dos seus tokens de API, é sua responsabilidade armazená-los, fazer backup e gerenciá-los com segurança.
Para exibir e gerenciar seus tokens de API no Omnissa Connect, vá para Configurações da Conta > Tokens de API.
- Para gerar novamente um token, selecione Gerar Novamente. Isso substitui o token existente por um novo. Para continuar chamando as APIs, você deve atualizar o token nas chamadas de API.
- Para desativar um token, selecione Revogar. Isso revoga o token de API e o token de acesso associado.
- Para impedir o acesso não autorizado aos recursos da sua organização, mantenha os tokens de API gerados em um local seguro e protegido. O Omnissa Connect não verifica se há prova de posse, mas captura eventos de auditoria de uso de token nos cenários listados.
- Um usuário gera um token de API.
- Um usuário revoga um ou todos os tokens pessoais.
- Um usuário faz uma tentativa malsucedida de gerar tokens de acesso por meio da atualização do token de API.
Observação: para exibir os logs de eventos de auditoria no Omnissa Connect, você deve ter uma função de Proprietário.
- Para adicionar uma camada extra de segurança às suas APIs, você pode adicionar autenticação multifator (MFA) aos seus tokens de API. Para mais detalhes, consulte Políticas de Autenticação.
O que acontece quando um token de API é desativado?
Se o seu token de API tiver sido desativado por um Proprietário por violar qualquer conjunto de políticas na organização ou por não aderir aos padrões da organização, você receberá uma notificação por e-mail do Omnissa Connect.
Vá para a guia Configurações da Conta > Tokens de API e encontre os tokens desativados que estão marcados com a etiqueta Desativado, que aparece ao lado do nome do Token de API.
Tarefas comuns ao usar tokens de API
Visualize uma lista das tarefas mais comuns de gerenciamento de autoatendimento de token de API.
| Se você desejar... | Faça isso... |
|---|---|
| Estender a validade de um token de API que expirou. | Você deve gerar seu token novamente. |
| Gerar novamente um token de API válido. | Você pode gerar novamente um token a qualquer momento. Se você gerar novamente um token, revogará todas as instâncias do token anterior. Se você tiver usado o token, por exemplo, em um dos seus scripts, lembre-se de substituí-lo pelo token recém-gerado. |
| Substituir um token de API comprometido. | Se achar que o token foi comprometido, você poderá revogá-lo para impedir o acesso não autorizado. Você pode gera um novo token para renovar a autorização. |
| Destruir um token de API que ainda está válido. | Você pode destruir um token de API válido revogando-o. |
| Recuperar um token de API perdido. | Os tokens perdidos não podem ser recuperados. Você deve revogar o token perdido e gerar um novo. |
| Reativar um token de API desativado por um Proprietário. | Se um token desativado ainda for válido, você deverá entrar em contato com o Proprietário e solicitar sua reativação. |
Como gerenciar minhas funções em uma organização
As funções são atribuídas pelos Proprietários, e você normalmente tem uma função de Organização e uma função de Serviço.
- Para obter detalhes sobre as funções da Organização, consulte Funções e permissões da organização.
- Para obter detalhes sobre as funções do Serviço, consulte Funções e permissões do serviço.
Use a página Configurações da Conta para visualizar e gerenciar suas funções.
- Na navegação à esquerda, selecione Configurações da Conta.
- Selecione a guia Minhas Funções.
- Para excluir uma função de Serviço ou uma função de Organização adicional que você não precisa mais, selecione o nome do serviço para expandir todas as funções que você tem para esse serviço. Depois de localizar a função de Serviço que você deseja remover, selecione Excluir Função. Para entrar em vigor, sua solicitação de exclusão de função deve ser aprovada por um Proprietário.
- Para visualizar as solicitações de função anteriores, role para baixo até a seção Meu Histórico de Solicitações da página.
- Para solicitar funções de Serviço adicionais para serviços já disponíveis na sua organização, selecione Solicitar Funções e faça uma seleção.
Como configurar minhas preferências de cookies
A Omnissa usa tecnologias de rastreamento para proteger e facilitar a prestação de serviços, fornecer suporte e recomendações, aprimorar o serviço e a experiência do usuário, além de outras finalidades de técnicas de análise descritas com mais detalhes em nosso Aviso de Privacidade.
Se você quiser desativar os cookies, configure suas preferências.
- Na navegação à esquerda do Omnissa Connect, selecione Configurações da Conta.
- Selecione a guia Cookies.
- Faça suas seleções.
Esta página foi útil?