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, actualizar y eliminar 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. Proporcione un título.
  8. Elija una carpeta en Mi contenido donde desee guardar el elemento.

    Como alternativa, puede elegir Crear nueva carpeta en el menú e introducir un nombre de carpeta para guardar el elemento en una carpeta nueva.

    Los nombres de carpeta no pueden contener caracteres Unicode de 4 bytes.

  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 el 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 con comas (por ejemplo, Federal land se interpreta como una etiqueta, en tanto que Federal, land se interpreta como dos etiquetas).

    A medida que escribe, puede elegir 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.

Crear elementos de credenciales de desarrollador

Como desarrollador con una cuenta de organización, cree un elemento de credenciales de desarrollador 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 GeoEnrichment. Para obtener más información sobre la autenticación y OAuth 2.0, consulte Esri Developer.

También puede crear credenciales de desarrollador para la autenticación de aplicaciones y para generar claves API.

El tipo de credenciales de desarrollador que crea 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. De lo contrario, solo puede utilizar credenciales de desarrollador OAuth 2.0.

Una vez que cree las credenciales de desarrollador, haga clic en Ver uso en la pestaña Configuración de la página del elemento de la aplicación para acceder a información sobre quién ha iniciado sesión en la aplicación y cuántos créditos ha consumido. También puede administrar ajustes para las credenciales integradas en la aplicación.

Nota:

La sección Ver uso no está disponible si se inicia sesión a través de una suscripción de ArcGIS Location Platform.

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.

Credenciales de OAuth 2.0 para autenticar usuarios

Complete los siguientes pasos si su aplicación requiere que los usuarios inicien sesión con una cuenta de ArcGIS Online.

  1. Compruebe que haya iniciado sesión con una cuenta de organización que tenga el privilegio para crear, actualizar y eliminar 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.

    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.

  4. Elija la opción Credenciales de OAuth 2.0: para la autenticación de usuarios y haga clic en Siguiente.
  5. 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

  6. En el cuadro URL, escriba una URL para su aplicación con el formato https://<myServer>/myWebMapApp.
  7. Haga clic en Siguiente.
  8. Proporcione un título.
  9. Elija una carpeta en Mi contenido donde desee guardar el elemento.

    Como alternativa, puede elegir Crear nueva carpeta en el menú e introducir un nombre de carpeta para guardar el elemento en una carpeta nueva.

    Los nombres de carpeta no pueden contener caracteres Unicode de 4 bytes.

  10. 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 el elemento.

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

  11. Opcionalmente, escriba etiquetas que describan el elemento.

    Separe los términos con comas (por ejemplo, Federal land se interpreta como una etiqueta, en tanto que Federal, land se interpreta como dos etiquetas).

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

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

    Se muestra el resumen de credenciales.

  14. Repase el resumen de credenciales. Para cambiar los ajustes, haga clic en Atrás y realice los cambios necesarios antes de crear el elemento.
  15. 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. En la pestaña Descripción general de la página del elemento, el distintivo indica si las credenciales incluyen privilegios personales o si solo incluyen privilegios estándar.

Credenciales de OAuth 2.0 para autenticar aplicaciones

Complete los siguientes pasos si su aplicación pública no requiere que los usuarios inicien sesión y genera tokens de acceso en el lado del servidor.

  1. Compruebe que haya iniciado sesión con una cuenta de organización que tenga el privilegio para crear, actualizar y eliminar 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.

    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.

  4. Elija la opción Credenciales de OAuth 2.0: para la autenticación de aplicaciones y haga clic en Siguiente.
  5. En ¿Dónde utilizará estas credenciales?, elija una de estas opciones:
    • Aplicación privada con acceso y privilegios seleccionados: elija esta opción para conceder acceso a cualquier conjunto de sus elementos y privilegios. Puede integrar esto en una aplicación privada o en un componente del lado del servidor utilizado por una aplicación pública.
    • Aplicación privada que actúa en su nombre: elija esta opción para conceder todos sus privilegios actuales junto con su acceso al contenido, los miembros y la configuración de la organización.
  6. Haga clic en Siguiente.
  7. Opcionalmente, si seleccionó Aplicación privada con acceso y privilegios seleccionados, elija una de las siguientes opciones:
    • Sin acceso a elementos: no se requiere acceso a elementos para esta credencial. Haga clic en Siguiente.
    • Conceder acceso a elementos mediante privilegios: seleccione los privilegios que se requieran para permitir el acceso a los elementos correspondientes a estas credenciales. Haga clic en Siguiente.
    • Conceder acceso a elementos específicos: primero debe seleccionar los elementos de su propiedad a los que desea conceder acceso. Haga clic en Siguiente.
  8. Opcionalmente, si seleccionó Aplicación privada con acceso y privilegios seleccionados, elija qué acciones permitirán las credenciales que realice la aplicación asignando privilegios. 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.

    Para obtener información sobre los tipos de privilegios, consulte la guía de seguridad y autenticación de la ayuda para desarrolladores de Esri.

  9. Haga clic en Siguiente.
  10. 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 especificadas durante la autorización deben coincidir con una de las direcciones URL registradas; de lo contrario, se rechaza la autorización.

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

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

  11. Haga clic en Siguiente.
  12. Proporcione un título.
  13. Elija una carpeta en Mi contenido donde desee guardar el elemento.

    Como alternativa, puede elegir Crear nueva carpeta en el menú e introducir un nombre de carpeta para guardar el elemento en una carpeta nueva.

    Los nombres de carpeta no pueden contener caracteres Unicode de 4 bytes.

  14. 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 el elemento.

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

  15. Opcionalmente, escriba etiquetas que describan el elemento.

    Separe los términos con comas (por ejemplo, Federal land se interpreta como una etiqueta, en tanto que Federal, land se interpreta como dos etiquetas).

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

  16. Si lo desea, agregue un resumen que describa la aplicación.
  17. Haga clic en Siguiente.

    Se muestra el resumen de credenciales.

  18. Repase el resumen de credenciales. Para cambiar los ajustes, haga clic en Atrás y realice los cambios necesarios antes de crear el elemento.
  19. Si seleccionó Aplicación privada que actúa en su nombre, haga clic en la casilla situada junto a Reconozco y acepto los requisitos de seguridad asociados con los privilegios seleccionados.
  20. Haga clic en Crear.

La aplicación se agrega a su contenido y aparece su página del elemento. Aparece un distintivo de credenciales de OAuth 2.0 que indica credenciales de OAuth 2.0 cuando el elemento se visualiza desde la página de contenido o desde los paneles de vista previa del elemento. En la pestaña Descripción general de la página del elemento, aparece el distintivo Credenciales de OAuth 2.0: actúa en nombre del propietario si eligió Aplicación privada que actúa en su nombre en ¿Dónde utilizará estas credenciales?

Crear credenciales de clave de API

Realice los pasos siguientes para crear claves de API

  1. Compruebe que ha iniciado sesión con una cuenta de organización y que dispone de los privilegios necesarios para crear claves API y crear, actualizar y eliminar 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. Elija la opción Credenciales de clave de API y haga clic en Siguiente.
  5. En ¿Dónde utilizará estas credenciales?, elija una de estas opciones:
    • Aplicación pública: elija esta opción para conceder acceso a elementos específicos y privilegios de servicio.
    • Aplicación privada con acceso y privilegios seleccionados: elija esta opción para conceder acceso a cualquier conjunto de sus elementos y privilegios. Puede integrar esto en una aplicación privada o en un componente del lado del servidor utilizado por una aplicación pública.
    • Aplicación privada que actúa en su nombre: elija esta opción para conceder todos sus privilegios actuales junto con su acceso al contenido, los miembros y la configuración de la organización.
  6. Haga clic en Siguiente.
  7. Opcionalmente, si seleccionó Aplicación pública, elija una de las siguientes opciones:
    • Sin acceso a elementos: no se requiere acceso a elementos para esta credencial. Haga clic en Siguiente.
    • Conceder acceso a elementos específicos: primero debe seleccionar los elementos de su propiedad y luego hacer clic en Siguiente.
  8. Conceder acceso a elementos específicos: primero debe seleccionar los elementos de su propiedad y luego hacer clic en Siguiente.
    • Sin acceso a elementos: no se requiere acceso a elementos para esta credencial. Haga clic en Siguiente.
    • Conceder acceso a elementos mediante privilegios: seleccione los privilegios que se requieran para permitir el acceso a los elementos correspondientes a estas credenciales. Haga clic en Siguiente.
    • Conceder acceso a elementos específicos: primero debe seleccionar los elementos de su propiedad y luego hacer clic en Siguiente.
  9. Opcionalmente, si seleccionó Aplicación pública o Aplicación privada con acceso y privilegios seleccionados, elija qué acciones permitirán las credenciales que realice la aplicación asignando privilegios. 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.

    Para obtener información sobre los tipos de privilegios, consulte la guía de seguridad y autenticación de la ayuda para desarrolladores de Esri.

  10. Opcionalmente, si seleccionó Aplicación privada que actúa en su nombre, use 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.

  11. 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 especificadas durante la autorización deben coincidir con una de las direcciones URL registradas; de lo contrario, se rechaza la autorización.

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

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

  12. Haga clic en Siguiente.
  13. Proporcione un título.
  14. Elija una carpeta en Mi contenido donde desee guardar el elemento.

    Como alternativa, puede elegir Crear nueva carpeta en el menú e introducir un nombre de carpeta para guardar el elemento en una carpeta nueva.

    Los nombres de carpeta no pueden contener caracteres Unicode de 4 bytes.

  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 el 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 con comas (por ejemplo, Federal land se interpreta como una etiqueta, en tanto que Federal, land se interpreta como dos etiquetas).

    A medida que escribe, puede elegir 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.

    Se muestra el resumen de credenciales.

  19. Repase el resumen de credenciales. Para cambiar los ajustes, haga clic en Atrás y realice los cambios necesarios antes de crear el elemento.
  20. Si seleccionó Aplicación privada que actúa en su nombre, haga clic en la casilla situada junto a Reconozco y acepto los requisitos de seguridad asociados con los privilegios seleccionados.
  21. 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. En la pestaña Descripción general de la página del elemento, el distintivo indica si las credenciales incluyen privilegios personales o si solo incluyen privilegios estándar.

Temas relacionados