Adicionar e registrar um aplicativo

A adição de uma referência de URL para um aplicativo existente é um caminho efetivo para compartilhar seu trabalho com membros da sua organização e o público (dependendo dos seus privilégios de compartilhamento). Além da URL, você pode compartilhar outros detalhes como o tipo de aplicativo, sua finalidade, resumo e descrição, e um arquivo .zip com o código usado para criar o aplicativo. Adicionar um aplicativo no ArcGIS Online apenas adiciona uma referência à URL do aplicativo; o ArcGIS Online não armazena os arquivos do aplicativo.

Como um desenvolvedor de aplicativo com uma conta organizacional, você também pode registrar aplicativos com a plataforma. Isso envolve o registro de um aplicativo OAuth para que membros da organização e usuários fora da organização possam entrar no aplicativo. Consulte a seção Adicionar e registrar um aplicativo usando credenciais de desenvolvedor abaixo para obter mais informações.

Caso não seja necessário registrar seu aplicativo—por exemplo, ao carregar uma amostra de código—siga as etapas na seção Adicionar um aplicativo a partir de uma URL abaixo.

Dica:

Outra maneira de compartilhar aplicativos com membros da sua organização e o público é criar aplicativos com mapas e aplicativos de galeria com grupos.

Adicionar um aplicativo a partir de uma URL

Para adicionar um item que usa uma URL para acessar um aplicativo na web, mas que não precisa ser registrado (por exemplo, amostras de código), complete as seguintes etapas:

Anotação:

Para adicionar um aplicativo registrado, siga as etapas para adicionar e registrar um aplicativo usando credenciais de desenvolvedor.

  1. Verifique se você está conectado e tem o privilégio de criar, atualizar e excluir conteúdo.
  2. Na guia Meu conteúdo da página de conteúdo, clique em Novo item e clique em Aplicativo.
  3. Escolha o tipo de aplicativo a partir das opções a seguir:
    • Mapeamento da web—Um aplicativo da web construído com uma API da web como JavaScript.
    • Desktop—Um aplicativo para desktops, construído em uma plataforma de desktop como Java ou .NET (Microsoft Windows Desktop).
    • Móvel—Um aplicativo que pode ser baixado, criado para dispositivos móveis com um kit de desenvolvimento de software (SDK) como iOS ou Android.
    • Outra aplicação—Um aplicativo de desktop, script Python ou qualquer tipo de aplicativo genérico para o qual você não tenha detalhes sobre a finalidade, API, SDK ou endereço URL do aplicativo.
  4. Para mapeamento móvel, desktop ou da web, forneça a URL do aplicativo, por exemplo, https://<myServer>/myWebMapApp.
  5. Para aplicativos de desktop, clique em Procurar e escolha o arquivo .zip que contém o aplicativo.
  6. Clique em Avançar.
  7. Forneça um título.
  8. Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.

    Alternativamente, escolha Criar nova pasta no menu e forneça um nome de pasta para salvar o item em uma nova pasta.

    Os nomes de pastas não podem conter caracteres Unicode de 4 bytes.

  9. Se a sua organização tiver configurado categorias de conteúdo, clique em Atribuir categorias e selecione até 20 categorias para ajudar usuários a encontrar o item.

    Você também pode começar digitando um nome de categoria para restringir a lista de categorias.

  10. Opcionalmente, forneça tags que descrevam o item.

    Separe os termos com vírgulas (por exemplo, Terra federal é considerado uma tag, eFederal, terra é considerado duas tags).

    Conforme você digita, é possível escolher qualquer uma das tags sugeridas que aparecem; as sugestões são geradas a partir das tags que você adicionou anteriormente.

  11. Opcionalmente, adicione um resumo que descreva o aplicativo.
  12. Clique em Salvar.

Após adicionar o aplicativo, ele aparecerá em seu conteúdo. Se você precisar registrá-lo posteriormente, poderá fazer na guia Configurações da página de item do aplicativo. Consulte a seção Adicionar e registrar um aplicativo usando credenciais de desenvolvedor abaixo para obter mais informações.

Você pode configurar os detalhes do item, anexar código, se necessário, e compartilhar o aplicativo se você tiver privilégios de compartilhamento.

Criar itens de credenciais de desenvolvedor

Como desenvolvedor com uma conta organizacional, crie um item de credenciais de desenvolvedor para gerar um ID de aplicativo. Utilize o ID do aplicativo no aplicativo para coletar as estatísticas de uso e permitir aos usuários entrar na plataforma com OAuth 2.0, uma estrutura de trabalho de autorização padronizada. Com o OAuth 2.0, os aplicativos guiam o usuário para entrar na plataforma através de uma página de registro da plataforma hospedada. Também permite ao aplicativo trabalhar com conteúdo de usuário associado com sua organização, como também, trabalhar com outros recursos do ArcGIS Online tais como, geocodificação, rota e GeoEnrichment. Para mais informações sobre autenticação e OAuth 2.0, consulte a documentação do Esri Developer .

Você também pode criar credenciais de desenvolvedor para autenticação de aplicativos e para gerar chaves de API.

O tipo de credenciais de desenvolvedor que você cria depende dos seus privilégios na organização. Se você for membro do papel de administrador padrão ou membro de um papel personalizado com o privilégio para gerar chaves de API, você pode usar uma credencial OAuth 2.0 ou uma chave de API. Caso contrário, você só poderá usar credenciais de desenvolvedor OAuth 2.0.

Após criar as credenciais de desenvolvedor, clique em Visualizar uso na guia Configurações da página do aplicativo para acessar informações sobre quem efetuou o login no aplicativo e a quantidade de créditos que consumiram. Você também pode gerenciar as configurações das credenciais incorporadas ao aplicativo.

Anotação:

A seção Visualizar uso não está disponível quando conectado por meio de uma assinatura do ArcGIS Location Platform.

O padrão de implementação para logins de usuário difere um pouco, dependendo se você está desenvolvendo um aplicativo baseado na web ou um aplicativo nativo.A documentação do Esri Developer inclui detalhes e amostras de código para aplicativos baseados na web e aplicativos nativos.

Criar credenciais OAuth 2.0 para autenticação de usuários

Se o aplicativo exigir que os usuários entrem com uma conta do ArcGIS Online, complete as seguintes etapas:

  1. Verifique se você está conectado com uma conta organizacional que tenha o privilégio de criar, atualizar e excluir conteúdo.
  2. Clique na guia Meu conteúdo da página de conteúdo, e clique em Novo item.
  3. Na janela Novo item, clique em Credenciais do desenvolvedor.

    A primeira janela apresentada será diferente dependendo dos seus privilégios na organização. Se você for membro de um papel que não inclua o privilégio para criar chaves API, vá para a etapa 5. Se o seu papel incluir privilégios para criar chaves API, vá para a etapa 4.

  4. Escolha a opção Credenciais OAuth 2.0—Para autenticação de usuário e clique em Avançar.
  5. Em Redirecionar URLs, forneça a URL de uma página da web ou de um parâmetro de servidor que será usado para redirecionar os usuários após o login bem-sucedido e clique em Adicionar para incluir mais URLs de redirecionamento, conforme necessário.

    As URLs de redirecionamento especificadas durante a autorização devem corresponder a uma das URLs registradas, caso contrário, a autorização será rejeitada.

    Um valor especial de urn:ietf:wg:oauth:2.0:oob também pode ser especificado para concessões de autorização. Isso resulta na entrega do código de autorização a uma, URL do portal (/oauth2/approval). Esse valor normalmente é usado por aplicativos que não têm um servidor da web ou um esquema de URL personalizado onde o código pode ser entregue.

    Veja a seguir exemplos de formatos de URL de redirecionamento suportados:

    • https://app.foo.com
    • urn:ietf:wg:oauth:2.0:oob

  6. Na caixa de texto URL, forneça uma URL para o aplicativo no formato https://<myServer>/myWebMapApp.
  7. Clique em Avançar.
  8. Forneça um título.
  9. Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.

    Alternativamente, escolha Criar nova pasta no menu e forneça um nome de pasta para salvar o item em uma nova pasta.

    Os nomes de pastas não podem conter caracteres Unicode de 4 bytes.

  10. Se a sua organização tiver configurado categorias de conteúdo, clique em Atribuir categorias e selecione até 20 categorias para ajudar usuários a encontrar o item.

    Você também pode começar digitando um nome de categoria para restringir a lista de categorias.

  11. Opcionalmente, forneça tags que descrevam o item.

    Separe os termos com vírgulas (por exemplo, Terra federal é considerado uma tag, eFederal, terra é considerado duas tags).

    Conforme você digita, é possível escolher qualquer uma das tags sugeridas que aparecem; as sugestões são geradas a partir das tags que você adicionou anteriormente.

  12. Opcionalmente, adicione um resumo que descreva o aplicativo.
  13. Clique em Avançar.

    O resumo das credenciais é exibido.

  14. Revise o resumo da credencial e, para alterar as configurações, clique em Voltar para fazer modificações antes de criar o item.
  15. Clique em Criar.

O aplicativo é adicionado ao seu conteúdo e a página do item aparece. Um selo de credenciais OAuth 2.0 indicando que as credenciais OAuth 2.0 são usadas com o aplicativo aparece na página do item e quando o item é visualizado na página de conteúdo ou nos painéis de visualização do item. Na guia Visão Geral da página do item, o emblema indica se privilégios pessoais estão incluídos ou se apenas privilégios padrão estão incluídos nas credenciais.

Criar credenciais OAuth 2.0 para autenticação de aplicativos

Se o aplicativo público não exigir que os usuários façam login e gerem tokens de acesso no lado do servidor, conclua as etapas a seguir:

  1. Verifique se você está conectado com uma conta organizacional que tenha o privilégio de criar, atualizar e excluir conteúdo.
  2. Clique na guia Meu conteúdo da página de conteúdo, e clique em Novo item.
  3. Na janela Novo item, clique em Credenciais do desenvolvedor.

    A primeira janela apresentada será diferente dependendo dos seus privilégios na organização. Se você for membro de um papel que não inclua o privilégio para criar chaves API, vá para a etapa 5. Se o seu papel incluir privilégios para criar chaves API, vá para a etapa 4.

  4. Escolha a opção Credenciais OAuth 2.0—para autenticação de aplicativo e clique em Avançar.
  5. Em Onde você usará essas credenciais, escolha uma das seguintes opções:
    • Aplicativo privado com privilégios e acesso selecionados—Selecione esta opção para conceder acesso a qualquer conjunto de seus itens e privilégios. Você pode incorporar isso em um aplicativo privado ou em um componente do lado do servidor usado por um aplicativo público.
    • Aplicativo privado que se faz passar por você—Selecione esta opção para conceder todos os seus privilégios atuais, juntamente com o seu acesso ao conteúdo, aos membros e às configurações da organização.
  6. Clique em Avançar.
  7. Opcionalmente, se você selecionou Aplicativo privado com os privilégios e o acesso selecionados, escolha uma das seguintes opções:
    • Sem acesso ao item—Não é necessário acesso a nenhum item para esta credencial. Clique em Avançar.
    • Conceder acesso ao item usando privilégios—São necessárias algumas permissões para permitir o acesso a itens com esta credencial. Clique em Avançar.
    • Conceda acesso a itens específicos—Primeiro, você deve selecionar os itens de sua propriedade possui para conceder acesso. Clique em Avançar.
  8. Opcionalmente, se você selecionou Aplicativo privado com os privilégios e o acesso selecionados, escolha as ações as credenciais permitirão que o aplicativo execute, atribuindo privilégios, e clique em Avançar.

    A lista de privilégios disponíveis para você varia dependendo de você possuir uma assinatura do ArcGIS Location Platform e dos privilégios que você tem na organização. Você não pode conceder privilégios que sua conta não tem.

    Para obter informações sobre os tipos de privilégios, consulte o Guia de segurança e autenticação na documentação de Desenvolvedor da Esri.

  9. Clique em Avançar.
  10. Em URLs de referência, forneça a URL ou endereço IP que tenha permissão para se conectar ao aplicativo e clique em Adicionar para adicionar mais URLs de referência ou endereços IP, conforme necessário.

    As URLs especificadas durante a autorização devem corresponder a uma das URLs registradas; caso contrário, a autorização será rejeitada.

    A seguir estão exemplos de formatos de URL de referência suportados:

    • https://www.example.com/pages
    • https://www.example.com/pages/index.html

  11. Clique em Avançar.
  12. Forneça um título.
  13. Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.

    Alternativamente, escolha Criar nova pasta no menu e forneça um nome de pasta para salvar o item em uma nova pasta.

    Os nomes de pastas não podem conter caracteres Unicode de 4 bytes.

  14. Se a sua organização tiver configurado categorias de conteúdo, clique em Atribuir categorias e selecione até 20 categorias para ajudar usuários a encontrar o item.

    Você também pode começar digitando um nome de categoria para restringir a lista de categorias.

  15. Opcionalmente, forneça tags que descrevam o item.

    Separe os termos com vírgulas (por exemplo, Terra federal é considerado uma tag, eFederal, terra é considerado duas tags).

    Conforme você digita, é possível escolher qualquer uma das tags sugeridas que aparecem; as sugestões são geradas a partir das tags que você adicionou anteriormente.

  16. Opcionalmente, adicione um resumo que descreva o aplicativo.
  17. Clique em Avançar.

    O resumo das credenciais é exibido.

  18. Revise o resumo da credencial e, para alterar as configurações, clique em Voltar para fazer modificações antes de criar o item.
  19. Se você selecionou Aplicativo privado que se faz passar por você, clique na caixa de seleção Eu reconheço e aceito os requisitos de segurança associados aos privilégios selecionados.
  20. Clique em Criar.

O aplicativo é adicionado ao seu conteúdo e a página do item aparece. Um selo credenciais OAuth 2.0 indicando que as credenciais OAuth 2.0 aparecem quando o item é visualizado na página de conteúdo ou nos painéis de visualização do item. Na guia Visão geral da página do item, o selo Credenciais OAuth 2.0 - representa o proprietário do item aparece se você selecionou Aplicativo privado que representa você em Onde você usará essas credenciais.

Criar credenciais da chave API

Para criar credenciais de chave API, complete as seguintes etapas:

  1. Verifique se você está conectado com uma conta organizacional com privilégios para criar chaves API e criar, atualizar e excluir conteúdo.
  2. Clique na guia Meu conteúdo da página de conteúdo, e clique em Novo item.
  3. Na janela Novo item, clique em Credenciais do desenvolvedor.
  4. Escolha a opção Credenciais de chave API e clique em Avançar.
  5. Em Onde você usará essas credenciais, escolha uma das seguintes opções:
    • Aplicativo público—Selecione esta opção para conceder acesso a itens específicos e privilégios de serviço.
    • Aplicativo privado com privilégios e acesso selecionados—Selecione esta opção para conceder acesso a qualquer conjunto de seus itens e privilégios. Você pode incorporar isso em um aplicativo privado ou em um componente do lado do servidor usado por um aplicativo público.
    • Aplicativo privado que se faz passar por você—Selecione esta opção para conceder todos os seus privilégios atuais, juntamente com o seu acesso ao conteúdo, aos membros e às configurações da organização.
  6. Clique em Avançar.
  7. Opcionalmente, se você selecionou Aplicativo público, escolha uma das seguintes opções:
    • Sem acesso ao item—Não é necessário acesso a nenhum item para esta credencial. Clique em Avançar.
    • Conceda acesso a itens específicos—Primeiro, você deve selecionar os itens de sua propriedade e clicar em Avançar.
  8. Opcionalmente, se você selecionou Aplicativo privado com os privilégios e o acesso selecionados, escolha uma das seguintes opções:
    • Sem acesso ao item—Não é necessário acesso a nenhum item para esta credencial. Clique em Avançar.
    • Conceder acesso ao item usando privilégios—São necessárias algumas permissões para permitir o acesso a itens com esta credencial. Clique em Avançar.
    • Conceda acesso a itens específicos—Primeiro, você deve selecionar os itens de sua propriedade e clicar em Avançar.
  9. Opcionalmente, se você selecionou Aplicativo público ou Aplicativo privado com os privilégios e o acesso selecionados, escolha as ações as credenciais permitirão que o aplicativo execute, atribuindo privilégios e clique em Avançar.

    A lista de privilégios disponíveis varia dependendo se você possui uma assinatura do ArcGIS Location Platform e quais privilégios possui na organização. Você não pode conceder privilégios que sua conta não tem.

    Para obter informações sobre os tipos de privilégios, consulte o Guia de segurança e autenticação na documentação de Desenvolvedor da Esri.

  10. Opcionalmente, se você selecionou Aplicativo privado que se passa por você, use o calendário para especificar uma data de expiração para as credenciais.

    As credenciais podem expirar no dia seguinte (mínimo) ou 365 dias depois (máximo). Elas expiram às 23h59 do dia que você escolher para vencimento. A hora é armazenada com base na hora do seu navegador quando você adiciona o aplicativo e gera as credenciais.

  11. Em URLs de referência, forneça a URL ou endereço IP que tenha permissão para se conectar ao aplicativo e clique em Adicionar para adicionar mais URLs de referência ou endereços IP, conforme necessário.

    As URLs especificadas durante a autorização devem corresponder a uma das URLs registradas; caso contrário, a autorização será rejeitada.

    A seguir estão exemplos de formatos de URL de referência suportados:

    • https://www.example.com/pages
    • https://www.example.com/pages/index.html

  12. Clique em Avançar.
  13. Forneça um título.
  14. Escolha uma pasta em Meu conteúdo onde você deseja salvar o item.

    Alternativamente, escolha Criar nova pasta no menu e forneça um nome de pasta para salvar o item em uma nova pasta.

    Os nomes de pastas não podem conter caracteres Unicode de 4 bytes.

  15. Se a sua organização tiver configurado categorias de conteúdo, clique em Atribuir categorias e selecione até 20 categorias para ajudar usuários a encontrar o item.

    Você também pode começar digitando um nome de categoria para restringir a lista de categorias.

  16. Opcionalmente, forneça tags que descrevam o item.

    Separe os termos com vírgulas (por exemplo, Terra federal é considerado uma tag, eFederal, terra é considerado duas tags).

    Conforme você digita, é possível escolher qualquer uma das tags sugeridas que aparecem; as sugestões são geradas a partir das tags que você adicionou anteriormente.

  17. Opcionalmente, adicione um resumo que descreva o aplicativo.
  18. Clique em Avançar.

    O resumo das credenciais é exibido.

  19. Revise o resumo da credencial e, para alterar as configurações, clique em Voltar para fazer modificações antes de criar o item.
  20. Se você selecionou Aplicativo privado que se faz passar por você, clique na caixa de seleção Eu reconheço e aceito os requisitos de segurança associados aos privilégios selecionados.
  21. Clique em Criar.

O aplicativo é adicionado ao seu conteúdo e a página do item aparece. Um selo de credenciais de chave API indicando que uma chave API está incorporada ao aplicativo aparece na página do item e quando o item é visualizado na página de conteúdo ou nos painéis de visualização do item. Na guia Visão Geral da página do item, o emblema indica se privilégios pessoais estão incluídos ou se apenas privilégios padrão estão incluídos nas credenciais.

Tópicos relacionados