Agregar y registrar una aplicación

Agregar una referencia URL a una aplicación existente es una forma eficaz de compartir su trabajo con los miembros de su organización y el público (en función de sus privilegios de uso compartido). Además de la URL, puede compartir otros detalles como el tipo de aplicación, su propósito, un resumen y una descripción, y un archivo .zip con el código utilizado para crear la aplicación. Agregar una aplicación a ArcGIS Online solo agrega una referencia a la URL de la aplicación; ArcGIS Online no almacena archivos de aplicaciones.

Como desarrollador de aplicaciones con una cuenta de organización, también puede registrar aplicaciones en la plataforma. Supone registrar una aplicación OAuth para que los miembros de la organización y los usuarios ajenos a la organización puedan iniciar sesión en la aplicación. Consulte la sección Agregar y registrar una aplicación con credenciales de desarrollador que aparece a continuación para obtener más información.

Si no necesita registrar su aplicación (por ejemplo, al cargar una muestra de código), siga los pasos que se indican en la sección Agregar una aplicación desde una dirección URL que aparece a continuación.

Sugerencia:

Otra forma de compartir aplicaciones con miembros de su organización y con el público es crear aplicaciones con mapas y aplicaciones de la galería con grupos.

Agregar una aplicación desde una dirección URL

Siga estos pasos para agregar un elemento que utilice una URL para acceder a una aplicación en la web, pero que no necesite estar registrada (por ejemplo, muestras de código):

Nota:

Para agregar una aplicación registrada, siga los pasos para agregar y registrar una aplicación con credenciales de desarrollador.

  1. Compruebe que haya iniciado sesión y que tenga privilegios para crear contenido.
  2. En la pestaña Mi contenido de la página de contenido, haga clic en Nuevo elemento y en Aplicación.
  3. Elija el tipo de aplicación:
    • Representación cartográfica en la red: una aplicación web creada con una API web como, por ejemplo, JavaScript.
    • Escritorio: una aplicación para ordenadores de escritorio creada sobre una plataforma de escritorio como, por ejemplo, Java o .NET (escritorio de Microsoft Windows).
    • Móvil: una aplicación descargable para móviles creada para dispositivos móviles con SDK, como iOS o Android.
    • Otra aplicación: una aplicación de escritorio, script de Python o cualquier tipo de aplicación genérica de cuyo propósito, API, SDK o dirección URL no tenga detalles.
  4. Para aplicaciones de representación cartográfica en la red, de escritorio o móviles, escriba la URL de la aplicación, por ejemplo, https://<myServer>/myWebMapApp.
  5. Para aplicaciones de escritorio, haga clic en Examinar y elija el archivo .zip que contiene la aplicación.
  6. Haga clic en Siguiente.
  7. Escriba un título.
  8. Elija una carpeta en Mi contenido donde desee guardar el elemento.
  9. Si su organización ha configurado categorías de contenido, haga clic en Asignar categorías y seleccione hasta 20 categorías para que resulte más fácil encontrar su elemento.

    También puede empezar a escribir el nombre de una categoría para acotar la lista de categorías.

  10. Opcionalmente, escriba etiquetas que describan el elemento.

    Separe los términos por comas (por ejemplo, Suelo federal se interpreta como una etiqueta, mientras que Suelo, federal se interpreta como dos etiquetas).

    A medida que escribe, puede seleccionar cualquiera de las etiquetas que se sugieren. Las sugerencias proceden de etiquetas agregadas anteriormente.

  11. Si lo desea, agregue un resumen que describa la aplicación.
  12. Haga clic en Guardar.

Una vez que haya agregado la aplicación, esta aparece en su contenido. Si necesita registrarla más tarde, puede hacerlo desde la pestaña Configuración de la página del elemento de la aplicación. Consulte la sección Agregar y registrar una aplicación con credenciales de desarrollador que aparece a continuación para obtener más información.

Puede configurar los detalles del elemento, adjuntar código en caso necesario y compartir la aplicación si tiene privilegios de uso compartido.

Agregar y registrar una aplicación con credenciales de desarrollador

Como desarrollador con una cuenta de organización, puede agregar y registrar su aplicación en la plataforma para generar un Id. de aplicación. Use el Id. de la aplicación para recopilar estadísticas de uso y permitir que los usuarios inicien sesión en la plataforma con OAuth 2.0, un marco de autorización estandarizado. Con OAuth 2.0, las aplicaciones guían al usuario a iniciar la sesión en la plataforma a través de una página de inicio de sesión alojada en la plataforma. Asimismo, permite a la aplicación trabajar con contenido del usuario asociado a su organización, así como trabajar con otras funciones de ArcGIS Online como, por ejemplo, la geocodificación, generación de rutas y el geoenriquecimiento. Para obtener más información sobre la autenticación y OAuth 2.0, consulte Esri Developer.

El tipo de credenciales de desarrollador que puede incluir con la aplicación depende de sus privilegios en la organización. Si es miembro del rol de administrador predeterminado o miembro de un rol personalizado que tiene el privilegio para generar claves de API, puede utilizar una credencial de OAuth 2.0 o una credencial de clave de API en su app. De lo contrario, solo puede utilizar credenciales de desarrollador OAuth 2.0 en una app.

Nota:

El patrón de implementación de los inicios de sesión del usuario difiere ligeramente según se trate de una aplicación basada en web o de una aplicación nativa. La documentación de Esri Developer contiene detalles y muestras de código para aplicaciones nativas y basadas en web.

Agregar y registrar una aplicación con credenciales de OAuth 2.0 integradas

Si utiliza credenciales de OAuth 2.0 con las aplicaciones que crea, el token de acceso se genera dinámicamente cuando se accede a la aplicación. El token de acceso tiene una validez máxima de 14 días.

Siga estos pasos si su rol no dispone del privilegio para crear claves de API.

  1. Compruebe que haya iniciado sesión con una cuenta de organización que tenga el privilegio para crear contenido.
  2. Haga clic en la pestaña Mi contenido de la página de contenido y haga clic en Nuevo elemento.
  3. En la ventana Nuevo elemento, haga clic en Credenciales de desarrollador.
  4. La primera ventana que se muestra será diferente en función de sus privilegios en la organización. Si es miembro de un rol que no dispone del privilegio para crear claves de API, vaya al paso 5. Si su rol dispone de privilegios para crear claves de API, vaya al paso 4.
  5. Elija la opción Credenciales de OAuth 2.0 y haga clic en Siguiente.
  6. En URL de redireccionamiento, indique la URL a una página web o extremo del servidor que se utilizará para redirigir a los usuarios después de que inicien sesión correctamente. Haga clic en Agregar para agregar más direcciones URL de redireccionamiento según sea necesario.

    Las URL de redireccionamiento especificadas durante la autorización deben coincidir con una de las direcciones URL registradas; de lo contrario, se rechazará la autorización.

    También se puede especificar un valor especial de urn:ietf:wg:oauth:2.0:oob para concesiones de autorización. Como resultado de esta operación, el código de autorización se entrega a una URL del portal (/oauth2/approval). Este valor se utiliza normalmente en aplicaciones que no tienen un servidor web ni un esquema de URL personalizado donde se pueda entregar el código.

    A continuación, se muestran algunos ejemplos de formatos de URL de redireccionamiento compatibles:

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

  7. En URL de referencia, indique una URL o una dirección IP que tenga permiso para conectarse. Haga clic en Agregar para agregar más URL de referencia o direcciones IP si es necesario.
  8. En Entorno de la aplicación, elija un entorno para la aplicación: Múltiple, Nativa, Navegador o Servidor.
  9. En el cuadro URL, escriba una URL para su aplicación con el formato https://<myServer>/myWebMapApp.
  10. Haga clic en Siguiente.

    Si es miembro de un rol con privilegios para asignar privilegios a las aplicaciones OAuth 2.0, al hacer clic en Siguiente se muestra una ventana en la que podrá definir lo que la aplicación está autorizada a hacer. Si no dispone de este privilegio, vaya al paso 12.

  11. Elija las acciones que las credenciales permitirán realizar a la aplicación mediante la asignación de privilegios y, a continuación, haga clic en Siguiente.

    La lista de privilegios de los que dispone varía en función de si dispone de una suscripción a ArcGIS Location Platform y de los privilegios que tenga en la organización. No puede conceder privilegios que su propia cuenta no posea.

  12. Haga clic en Examinar elementos y elija los elementos a los que se puede acceder con las credenciales integradas. A continuación, haga clic en Agregar elementos.

    Como alternativa, puede hacer clic en Omitir. Si omite la especificación de qué elementos tienen acceso los usuarios de las credenciales de OAuth 2.0, las credenciales podrán utilizarse para acceder a todos los elementos de su propiedad.

  13. Escriba un título.
  14. Elija una carpeta en Mi contenido donde desee guardar el elemento.
  15. Si su organización ha configurado categorías de contenido, haga clic en Asignar categorías y seleccione hasta 20 categorías para que resulte más fácil encontrar su elemento.

    También puede empezar a escribir el nombre de una categoría para acotar la lista de categorías.

  16. Opcionalmente, escriba etiquetas que describan el elemento.

    Separe los términos por comas (por ejemplo, Suelo federal se interpreta como una etiqueta, mientras que Suelo, federal se interpreta como dos etiquetas).

    A medida que escribe, puede seleccionar cualquiera de las etiquetas que se sugieren. Las sugerencias proceden de etiquetas agregadas anteriormente.

  17. Si lo desea, agregue un resumen que describa la aplicación.
  18. Haga clic en Siguiente.
  19. Repase el resumen de credenciales. Para cambiar los ajustes, haga clic en Atrás y haga los cambios necesarios antes de crear el elemento. Si los ajustes de las credenciales son correctos, haga clic en Crear.

La aplicación se agrega a su contenido y aparece su página del elemento. La página del elemento exhibe un distintivo Credenciales de OAuth 2.0 que indica que se utilizan credenciales OAuth 2.0 con la aplicación y cuándo aparece en la página de contenido o los paneles de vista previa del elemento.

Puede configurar los detalles del elemento de la aplicación.

En la pestaña Configuración de la página del elemento de la aplicación, puede ver la información de registro, entre la que se encuentra el Id. de aplicación (Id. de cliente), un secreto de aplicación (Secreto de cliente) y los entornos de la aplicación. Puede actualizar la URL de la fuente de datos o las URL de redireccionamiento, restablecer el secreto, dar de baja la aplicación o copiar o renovar el token de aplicación temporal. También puede modificar los privilegios de que dispone la aplicación y alterar a qué capas puede acceder la aplicación.

Nota:

Al restablecer el secreto de la aplicación, quedan invalidados todos los tokens de usuario y de aplicación existentes generados para la aplicación. Los usuarios deben iniciar sesión de nuevo en la aplicación y quizás sea necesario actualizar las aplicaciones configuradas con el secreto.

Haga clic en Ver uso en la pestaña Configuración para acceder a la información sobre quién ha iniciado sesión en la aplicación y el número de créditos que ha consumido.

Agregar y registrar una aplicación con credenciales de clave de API integradas

Utilice las credenciales de clave de API cuando necesite integrarlas en la aplicación y necesite que la clave sea válida durante más de 14 días.

Siga estos pasos para agregar una aplicación y crear una clave de API integrada con ella para utilizarla con fines de autenticación.

  1. cCompruebe que ha iniciado sesión con una cuenta de organización y que dispone de los privilegios necesarios para crear contenidos y crear claves de API.
  2. Haga clic en la pestaña Mi contenido de la página de contenido y haga clic en Nuevo elemento.
  3. En la ventana Nuevo elemento, haga clic en Credenciales de desarrollador.
  4. Elija la opción Credenciales de clave de API y haga clic en Siguiente.
  5. Utilice el calendario para especificar una fecha de caducidad para las credenciales.

    Las credenciales pueden caducar al día siguiente (mínimo) o en 365 días (máximo). Caducan a las 23:59 horas de la fecha que usted elija para la caducidad. La hora se almacena en función de la hora de su navegador cuando agrega la aplicación y genera las credenciales.

  6. En URL de referencia, indique la URL o la dirección IP que puede conectarse a la aplicación. Haga clic en Agregar para agregar más URL de referencia o direcciones IP necesarias.

    Las URL de redireccionamiento especificadas durante la autorización deben coincidir con una de las direcciones URL registradas; de lo contrario, se rechazará la autorización.

  7. Haga clic en Siguiente.
  8. Elija las acciones que las credenciales permitirán realizar a la aplicación mediante la asignación de privilegios y, a continuación, haga clic en Siguiente.

    La lista de privilegios de los que dispone varía en función de si dispone de una suscripción a ArcGIS Location Platform y de los privilegios que tenga en la organización. No puede conceder privilegios que su propia cuenta no posea.

  9. Haga clic en Examinar elementos, elija los elementos a los que se puede acceder con las credenciales integradas. A continuación, haga clic en Agregar elementos.

    Como alternativa, puede hacer clic en Omitir. Si omite la especificación de qué elementos tienen acceso los usuarios de la clave de API, las credenciales podrán utilizarse para acceder a todos los elementos de su propiedad.

  10. Escriba un título.
  11. Elija una carpeta en Mi contenido donde desee guardar el elemento.
  12. Si su organización ha configurado categorías de contenido, haga clic en Asignar categorías y seleccione hasta 20 categorías para que resulte más fácil encontrar su elemento.

    También puede empezar a escribir el nombre de una categoría para acotar la lista de categorías.

  13. Opcionalmente, escriba etiquetas que describan el elemento.

    Separe los términos por comas (por ejemplo, Suelo federal se interpreta como una etiqueta, mientras que Suelo, federal se interpreta como dos etiquetas).

    A medida que escribe, puede seleccionar cualquiera de las etiquetas que se sugieren. Las sugerencias proceden de etiquetas agregadas anteriormente.

  14. Si lo desea, agregue un resumen que describa la aplicación.
  15. Haga clic en Siguiente.
  16. Repase el resumen de credenciales. Para cambiar los ajustes, haga clic en Atrás y haga los cambios necesarios antes de crear el elemento. Si los ajustes de las credenciales son correctos, haga clic en Crear.

La aplicación se agrega a su contenido y aparece su página del elemento. La página del elemento muestra un distintivo de credenciales de clave de API que indica que la aplicación integra una clave de API y cuándo se visualiza desde la página de contenido o los paneles de vista previa del elemento.

Puede configurar los detalles del elemento de la aplicación.

En la pestaña Configuración de la página del elemento de la aplicación, puede ver la información de registro, entre la que se encuentra el Id. de aplicación (Id. de cliente), un secreto de aplicación (Secreto de cliente) y los entornos de la aplicación. Puede actualizar las URL de redireccionamiento, restablecer el secreto, dar de baja la aplicación o copiar o renovar el token de aplicación temporal. También puede modificar los privilegios de que dispone la aplicación y alterar a qué capas puede acceder la aplicación.

Nota:

Al restablecer el secreto del cliente, quedan invalidados todos los tokens de usuario y de aplicación existentes generados para la aplicación. Los usuarios deben iniciar sesión de nuevo en la aplicación y quizás sea necesario actualizar las aplicaciones configuradas con el secreto.

Haga clic en Ver uso en la pestaña Configuración para acceder a la información sobre quién ha iniciado sesión en la aplicación y el número de créditos que ha consumido.

Temas relacionados