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 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 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 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 GeoEnrichment. Para obtener más información sobre la autenticación y OAuth 2.0, consulte Esri Developer.

También puede integrar una clave de API en la aplicación en el moment de registrarla.

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, 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. 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.

    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.

  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.

  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 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 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 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 realice los cambios necesarios antes de crear el elemento.
  20. Si ha concedido privilegios personales para las credenciales, active la casilla situada junto a la confirmación de seguridad para confirmar que la ha leído y está de acuerdo con ella, y haga clic en Crear para crear las credenciales.

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.

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

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.

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.

También puede administrar ajustes para las credenciales integradas en la aplicación.

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

  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.

    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 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.

  10. Proporcione un título.
  11. 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.

  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 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 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 realice los cambios necesarios antes de crear el elemento.
  17. Si ha concedido privilegios personales para las credenciales, active la casilla situada junto a la confirmación de seguridad para confirmar que la ha leído y está de acuerdo con ella, y haga clic en Siguiente.
  18. Elija si desea generar la clave API inmediatamente o más tarde y haga clic en Siguiente.

    Debe copiar la clave API en cuanto se genere.

    • Si hace clic en la opción Generar la clave de API e ir a la página de detalles del elemento. Todo listo para copiar y guardar la clave., aparece el elemento desplegable Generar clave de API al hacer clic en Siguiente. Haga clic en el botón Copiar para copiar la clave. Pegue la clave en un documento seguro. Cierre el elemento emergente al finalizar.
    • Si hace clic en la opción Ir a la página de detalles del elemento. Generaré la clave de API más adelante., aparece la página del elemento de credenciales. La página del elemento aparece al hacer clic en Siguiente. Puede generar la clave de API desde la pestaña Configuración de la página del elemento.

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.

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

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.

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.

También puede administrar ajustes para las credenciales integradas en la aplicación.

Temas relacionados