Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

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.

As seguintes características dizem respeito aos símbolos de API do usuário:

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

  • A Juniper Mist remove automaticamente um símbolo de API que não é usado há 90 dias consecutivos.

  • O identificador uniforme de recursos (URI) base para a API da Juniper Mist é {api_endpoint}/api/v1/.

    Nota:

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

Na Juniper Mist, existem dois tipos de fichas de API:
  • Símbolo da organizaçã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

    • O símbolo persiste em uma conta de usuário específica.
    • 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.

Crie um símbolo de organização

  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 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_endpoint}/api/v1/self/apitokens.
    Nota:

    No lugar de {api_endpoint}, 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.