Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
NESTA PÁGINA
 

Criar símbolos de API

Os símbolos de API contêm informações de autenticação e estão vinculados a usuários específicos ou a uma organização inteira. Os símbolos de API enviam informações de identificação sobre o usuário ou organização para o servidor de API para indicar se o usuário tem ou não acesso à API, para garantir a segurança.

Como muitos outros provedores de API, a Juniper Mist oferece uma maneira de gerar fichas de API para autenticação (no cabeçalho HTTP). Ao considerar os símbolos, a Juniper Mist usa os termos de ficha e chave de forma intercambiável.

Na Juniper Mist, existem dois tipos de fichas de API:

  • Símbolo da organização

    Os símbolos da organização são úteis quando você está construindo um aplicativo que automatiza o trabalho para sua organização. Vários usuários precisariam acessar o aplicativo e, portanto, usariam o mesmo símbolo da organização para autenticação.

    • O símbolo persiste sob a organização Mist.
    • O símbolo não está vinculado a nenhum usuário específico, o que significa que o acesso não depende do acesso de qualquer usuário à organização.
    • Oferece suporte a símbolos N org, que podem ter privilégios diferentes.
    • O símbolo só pode ser usado para essa organização específica.
    • A limitação de taxa é feita pelo símbolo individual. Por exemplo, se o OrgToken1 consumir 5000 chamadas de API e atingir o limite de taxa, o OrgToken2 não será afetado.

  • Símbolo do usuário

    Os símbolos do usuário são úteis quando você precisa autenticar por si mesmo, como quando executa um script, por exemplo.

    • O símbolo da API assume os mesmos privilégios que os privilégios da conta do usuário atribuído.

    • O símbolo está vinculado ao usuário específico, o que significa que o acesso correlaciona-se diretamente com o acesso do usuário à organização.
    • O símbolo pode ser usado para qualquer provedor de serviços gerenciados (MSP) ou organização a que o usuário tenha acesso.
    • Oferece suporte a N , que todos têm o mesmo privilégio que a conta do usuário.
    • O limite de taxa é feito pela conta vinculada ao usuário. Por exemplo, se o UserToken1 consumir 5000 chamadas de API e atingir o limite de taxa, o login de conta do UserToken2 e do UserToken2 na GUI será afetado.

Você pode criar fichas de API através do Portal Mist ou rest API Explorer.

Crie um símbolo de organização no portal Mist

  1. No menu à esquerda do portal Juniper Mist, selecione Configurações de > de administração da Organização >.
  2. Role até a seção de Símbolo de API e clique em Criar Um Símbolo.
  3. Selecione um nível de acesso para definir as permissões para o símbolo.

  4. Clique em Gerar.
  5. Clique no botão de cópia ao lado do campo Chave e armazene-o em algum lugar para manter a segurança.
    Nota:

    A única vez que você verá toda a chave não confiável é após a criação. Você nunca mais poderá ver a chave completa. Se você perder a chave, você terá que criar uma nova chave.

  6. Clique em Feito na parte inferior da janela.
  7. Clique em Salvar perto do canto superior direito da página.

Crie um símbolo de usuário no portal Mist

Você pode gerar um símbolo de usuário de API na página Minha Conta no portal Mist.

Para gerar um símbolo de usuário de API:

  1. No canto superior direito do portal Juniper Mist, clique no ícone da Conta Juniper Mist e clique em Minha conta.
  2. Na seção API Token, clique em Criar Um Símbolo. Se você tiver habilitado uma única inscrição para sua organização, você não será capaz de criar fichas de usuário de API.
  3. Insira um nome para o símbolo e clique em Gerar. A chave gerada é o símbolo da API do usuário.
  4. Clique no botão de cópia ao lado do campo chave.

    Certifique-se de armazenar a chave em algum lugar para manter a segurança, pois você não poderá ver a chave completa novamente. Se você perder a chave, você precisará criar uma nova chave.

  5. Clique em Pronto.
    Nota:

    Se você precisar excluir um símbolo de usuário, clique no símbolo na seção de Símbolo de API da página Meu Perfil e clique em Excluir na página Editar Símbolo.

Crie um símbolo de usuário ou organização usando o REST API Explorer

  1. Faça login no portal Juniper Mist.
    Nota:

    Você deve estar logado no portal para usar o REST API Explorer.
  2. Abra uma nova janela do navegador e cole sua URL: {api-host}/api/v1/self/apitokens.
    Nota:

    No lugar de {api-host}, você precisa usar o endpoint de API para sua região global. Veja endpoints de API e regiões globais.

    Rest API Explorer é a página de API para controle de fichas. Aqui você pode criar, ler, atualizar e excluir fichas e informações sobre fichas. Esta página exibe inicialmente os símbolos que você já criou.

    Esta página também permite que você e outros usuários façam uma chamada de API diretamente do navegador. Com tipo de mídia: aplicativos/json já selecionados como padrão, uma solicitação GET será realizada para mostrar a você uma lista de seus símbolos. Uma chave truncada será exibida para quaisquer símbolos criados anteriormente.

  3. Clique em POST.

    A resposta será semelhante a este exemplo:

  4. Copie a chave (ficha) e armazene-a para manter a segurança.
    Nota:

    A API da Juniper Mist nunca mais exibirá o símbolo (chave) real na íntegra, em qualquer lugar, depois de criar a chave. Depois de navegar para longe desta página e voltar, a chave aparecerá, mas em uma versão truncada. Você deve tratar essa chave como uma senha e armazená-la em um lugar seguro. Se você perder essa chave, você precisará criar uma nova.