Cómo interactúan los desarrolladores de apps con tu portal (versión original)

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

El portal para desarrolladores listo para usar permite que los desarrolladores de tus apps registren, accedan y administren las apps que consumirán tus APIs.

En las siguientes secciones, se describe cómo interactúan los desarrolladores de apps con tu portal:

Cómo se hace el seguimiento del registro y el acceso del desarrollador de apps en Edge

Se realiza un seguimiento del registro del desarrollador y del acceso al portal con el atributo personalizado _apiportal en Edge.

Cuando un desarrollador se registra automáticamente, se agrega el atributo personalizado _apiportal a la configuración del desarrollador, y su estado se establece en unverified para indicar que este no accedió al portal. Por ejemplo: {"status":"unverified","portals":{}}

La primera vez que el desarrollador accede a un portal, el atributo personalizado _apiportal se actualiza para realizar un seguimiento del nombre del portal y la hora de acceso, y establecer el estado del desarrollador en active. Cada vez que el desarrollador accede al portal, se actualiza el atributo personalizado para restablecer el valor de lastVisit (en formato epoch) de ese portal. Por ejemplo: {"status":"active","portals":{"myorg-myportal":{"lastVisit":1480972935}}}.

Registra una cuenta de desarrollador de apps

Para que los desarrolladores de apps puedan usar tus APIs, deben registrarse creando una cuenta.

Cuando un desarrollador de apps se registra en tu portal:

Como alternativa, puedes registrar a los desarrolladores de apps en su nombre con la IU de Edge, como se describe en Registra desarrolladores de apps.

Los nuevos desarrolladores de apps pueden registrarse automáticamente en tu portal de la siguiente manera:

  1. Navegue al portal.
  2. Haga clic en Acceder.
  3. Haz clic en Registrarse.
    Se mostrará el siguiente diálogo.

    Crear cuenta

  4. Ingresa la información requerida (nombre, apellido y dirección de correo electrónico).

  5. Haz clic en Crear.
    Se mostrará el siguiente diálogo.

    Acceder al portal

  6. Haga clic en el vínculo seguro del correo electrónico para abrir el portal y establecer la sesión autenticada.

Accede a tu portal

Una vez que los desarrolladores de apps se registran en tu portal, acceden con la página de acceso.

Cada vez que un desarrollador de apps accede a un portal, en lugar de usar un secreto compartido como una contraseña para autenticarlo, se envía un vínculo seguro a fin de verificar la identidad y establecer una sesión con el portal.

Los desarrolladores de apps pueden acceder a tu portal de la siguiente manera:

  1. Navegue al portal.
  2. Haga clic en Sign in.
  3. Ingresa la dirección de correo electrónico asociada con la cuenta.
  4. Haz clic en Login.
    Se mostrará el siguiente diálogo.

    Acceder al portal

  5. Haga clic en el vínculo seguro del correo electrónico para abrir el portal y establecer la sesión autenticada.

Registrar apps

Después de acceder al portal, los desarrolladores de apps pueden registrar apps para usar los productos de API que hayas publicado de la siguiente manera:

  1. Selecciona Mis apps en el menú desplegable del usuario.
  2. Haga clic en + Aplicación para crear una aplicación nueva.
  3. Ingresa un nombre y una descripción para la app en el diálogo Crear app.
  4. Haz clic en Crear.
  5. Administra los productos de API en la app, como se describe a continuación.

Administra los productos de API en una app

Los desarrolladores de apps pueden administrar los productos de API en sus apps. Los productos de API se agregan a la página de detalles de la app. Para algunos productos de API, la aprobación no es automática. El estado Pendiente indica que hay un producto de API para el que se solicitó acceso, pero aún no se otorgó.

Los desarrolladores de apps pueden administrar los productos de API en una app desde tu portal de la siguiente manera:

  1. Selecciona Mis apps en el menú desplegable del usuario.
  2. Haz clic en el nombre de la app.
  3. Haz clic en Administrar productos.
  4. Haz clic en el botón de activación Acceso para habilitar o inhabilitar el acceso a un producto de API desde la app.

    Nota: Si el desarrollador de la app inhabilita el acceso a un producto de API que es privado o solo interno, el producto de API se quitará de la app y el administrador del portal deberá volver a agregarlo manualmente, como se describe en Registra apps y administra claves de API.

  5. Haz clic en Solicitar para solicitar la aprobación de un producto de API que aún no está permitido.

  6. Haz clic en Guardar.

Cómo ver la clave de API de una app

Los desarrolladores de apps pueden administrar la clave de API para una app desde tu portal de la siguiente manera:

  1. Selecciona Mis apps en el menú desplegable del usuario.
  2. Haz clic en el nombre de la app.
  3. Consulta la clave de API en la sección Claves.
  4. Haz clic en Ver secreto para mostrar el secreto de la clave de API.
  5. Confirma que el estado de la clave de API sea Aprobada.

Rota la clave de API de una aplicación

Un desarrollador de apps puede rotar la clave de API de una app de forma periódica o en respuesta a una posible filtración o compromiso. Cuando un desarrollador de apps rota una clave de API, se crea una nueva con los mismos derechos de productos de API que la clave original. La clave de API original se marca como obsoleta, pero permanecerá activa mientras la deje de usarse. Debes desactivar una clave obsoleta para evitar que se acepten sus credenciales, tal como se describe en Cómo desactivar una clave de API para una app.

Los desarrolladores de apps pueden rotar la clave de API primaria de una app desde tu portal de la siguiente manera:

  1. Selecciona Mis apps en el menú desplegable del usuario.
  2. Haz clic en el nombre de la app.
  3. En la sección Claves, coloca el cursor sobre la clave de API actual para mostrar el menú de acciones.
  4. Haz clic en Ícono de expansión para expandir el menú de acciones.
  5. Haz clic en Rotar.
  6. Haz clic en Crear en el cuadro de diálogo para confirmar la operación.
  7. De manera opcional, desactiva la clave de API, tal como se describe a continuación.

Cómo desactivar una clave de API para una app

Cuando un desarrollador de apps rota una clave de API, como se describe en la sección anterior, la clave de API se marca como obsoleta, pero permanecerá activa mientras se deja de usar. Debes desactivar una clave obsoleta para evitar que se acepten sus credenciales.

Los desarrolladores de apps pueden desactivar una clave de API para una app desde tu portal de la siguiente manera:

  1. Selecciona Mis apps en el menú desplegable del usuario.
  2. Haz clic en el nombre de la app.
  3. En la sección Claves, haz clic en Historial de claves para mostrar la lista de claves obsoletas.
  4. Coloca el cursor sobre la clave de API obsoleta que desees desactivar para mostrar el menú de acciones.
  5. Haz clic en Ícono de expansión para expandir el menú de acciones.
  6. Haz clic en Desactivar.
  7. Haz clic en Desactivar para confirmar la operación.
    El estado de la clave se actualiza a Revocado.

Editar detalles de la aplicación

Los desarrolladores de apps pueden editar los detalles de la app de la siguiente manera:

  1. Selecciona Mis apps en el menú desplegable del usuario.
  2. Haz clic en el nombre de la app.
  3. Edita los campos Nombre o Descripción.
  4. Haz clic en Guardar.

La aplicación se elimina y se elimina de la lista Mis aplicaciones.

Cómo borrar una app

Los desarrolladores de apps pueden borrar una app de tu portal de la siguiente manera:

  1. Selecciona Mis apps en el menú desplegable del usuario.
  2. Haz clic en el nombre de la app.
  3. Haz clic en borrar en la esquina superior derecha de la página.

La aplicación se elimina y se elimina de la lista Mis aplicaciones.