Cómo interactúan los usuarios con tu portal

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

El portal para desarrolladores listo para usar permite a los usuarios de tu portal crear una cuenta de desarrollador, acceder y administrar las apps que consumirán tus API.

En las siguientes secciones, se describe cómo interactúan los usuarios del portal con tu portal.

Accede al portal

En las siguientes secciones, se describe cómo los usuarios de portal acceden al portal integrado con sus credenciales de usuario (proveedor de identidad integrado) o mediante SAML (beta).

Si habilita los proveedores de identidad integrados y de SAML, los usuarios del portal podrán elegir su método preferido para acceder.

Accede al portal con credenciales de usuario (proveedor de identidad integrado)

Nota: La página de acceso solo se puede editar para cambiar el logotipo de la empresa, como se describe en Configura la experiencia de creación de cuentas de usuario y su acceso.

Cuando se habilita el proveedor de identidad integrado, los usuarios del portal pueden acceder al portal integrado con sus credenciales de usuario (nombre de usuario y contraseña), como se describe en las siguientes secciones:

• Crea una cuenta de desarrollador en el portal integrado
• Accede al portal integrado
• Cambia la contraseña

Crea una cuenta de desarrollador en el portal integrado

Con el proveedor de identidad integrado, antes de que los usuarios del portal puedan usar tus API, deben crear una cuenta de desarrollador en el portal integrado.

Punto clave: Consulta también Dónde se almacena la información de la cuenta de desarrollador de la app.

Si bien es posible crear cuentas de usuario en nombre de usuarios del portal mediante la IU de administración de Edge, como se describe en Cómo registrar desarrolladores de apps, no se recomienda a fin de garantizar que las cuentas de usuario en el portal integrado y el registros del desarrollador en Edge se mantengan sincronizados.

Los usuarios del portal crean una cuenta en el portal integrado de la siguiente manera:

1. Navegue al portal.

2. Haga clic en Sign In.

   Aparecerá la página de acceso.

3. Haz clic en Crear cuenta.

   Se mostrará la página Crea tu cuenta.

   

   Nota: Puedes agregar campos de registro personalizados a la página de creación de cuenta, como se describe en Agregar campos de registro personalizados a la página de creación de la cuenta.

4. Completa el formulario.

   Debes ingresar valores para todos los campos obligatorios. Las contraseñas deben tener al menos 8 caracteres y contener al menos uno de los siguientes caracteres: número, letra minúscula, letra mayúscula y carácter especial.

5. Revisa y acepta las condiciones.

6. Haga clic en Create Account.
   

   Nota: Si se intenta crear una cuenta con un ID de correo electrónico que ya se registró, aparecerá un mensaje que indica que la cuenta ya existe y que se alentará al usuario del portal para que acceda.
   1. Completa el formulario de CAPTCHA y haz clic en Verificar (si aparece).

   Se crea la cuenta de desarrollador y se envía un correo electrónico de confirmación.

   Nota: Puede configurar el correo electrónico de confirmación, como se describe en Configura notificaciones por correo electrónico. Apigee recomienda configurar el servidor SMTP que se usa para las notificaciones por correo electrónico que se originan en el portal antes de su lanzamiento, como se describe en Configura el servidor SMTP.

7. En el plazo de 10 minutos, haz clic en el vínculo del correo electrónico de confirmación para completar el proceso de registro.

   Si no haces clic en el vínculo dentro de los 10 minutos siguientes, debe repetir los pasos en este procedimiento para crear una cuenta y volver a solicitarlo.

8. Accede al portal integrado (se describe a continuación).

Accede al portal integrado

Con el proveedor de identidad integrado, una vez que los usuarios del portal se hayan registrado en el portal integrado y hayan sido aprobados, deberán acceder con sus credenciales (nombre de usuario y contraseña).

Notas:

• Nota: Luego de 24 horas de inactividad, la sesión caducará, el usuario del portal se cerrará automáticamente y deberás volver a acceder.
• Si configuraste tu portal integrado para que requiera la activación manual de las cuentas de usuario, debes activar manualmente las cuentas de usuario antes de que los usuarios del portal puedan acceder. En este momento, los usuarios del portal no reciben la indicación de que su registro se debe activar manualmente antes de que puedan acceder. Si configuras la activación manual, te recomendamos que agilices la activación de las nuevas cuentas de usuario.
• Para navegar directamente a la página de acceso, usa la siguiente URL:
  https://portal-url/login

Los usuarios del portal acceden de la siguiente manera:

1. Navegue al portal.
2. Haga clic en Sign In.
   Aparecerá la página de acceso.
   
3. Ingresa la dirección de correo electrónico y la contraseña.
4. Haga clic en Sign In.

Cambia la contraseña

Con el proveedor de identidad integrado, los usuarios del portal cambian la contraseña de la siguiente manera:

1. Navegue al portal.
2. Haga clic en Sign In.
3. Haga clic en Restablecer contraseña.
4. Ingresa la dirección de correo electrónico de la cuenta que se restablecerá.

5. Haz clic en Enviar vínculo de restablecimiento de contraseña.

   Se enviará un vínculo para restablecer la contraseña al correo electrónico.

   Nota: Para configurar el servidor SMTP, consulta Cómo configurar el servidor SMTP.

6. Haz clic en el vínculo del correo electrónico de confirmación.

7. Ingresa la nueva contraseña y confírmala.

   Las contraseñas deben tener al menos 8 caracteres y contener al menos uno de los siguientes caracteres: número, letra minúscula, letra mayúscula y carácter especial.

8. Haz clic en Crear nueva contraseña.

Accede al portal con la autenticación de SAML (Beta)

Nota: Esta es la Versión beta del proveedor de identidad SAML.

Nota: La página de acceso solo se puede editar para cambiar el logotipo de la empresa como se describe en Configura la experiencia de creación de cuentas de usuario y su acceso.

Cuando el Proveedor de identidad SAML está habilitado, los usuarios del portal acceden al portal integrado con autenticación SAML, de la siguiente manera:

1. Navegue al portal.
2. Haga clic en Sign In.

3. Haz clic en Acceder con SAML.

   Se te redireccionará al proveedor de SAML.

4. Si se te solicita, ingresa tus credenciales para el proveedor de identidad SAML.

Nota: Luego de 24 horas de inactividad, la sesión caducará y el usuario del portal se cerrará automáticamente y deberá volver a acceder.

Visualiza la documentación de referencia de la API

Los usuarios del portal pueden ver la documentación de referencia de la API que publicaste en tu portal de la siguiente manera:

1. Navegue al portal.

2. Haz clic en API en la barra de navegación superior.
   Se muestra la página de API. Por ejemplo:
   
   

3. Filtre la lista de API por categoría, título o descripción, si lo deseas, mediante las herramientas del panel izquierdo.

4. Haz clic en una tarjeta de API para ver la documentación de referencia de la API.
   Se muestra la documentación de referencia de la API.

Los usuarios del portal pueden aprender sobre las API y probarlas, o descargar el documento usado para renderizar la documentación de referencia de la API. Consulta Publica tus API para obtener más información sobre cómo se renderiza la documentación de referencia de la API.

Comparte la responsabilidad de una app con equipos de desarrolladores (beta)

Nota: Debes estar inscrito en la versión beta de la función de equipos.

Los equipos de desarrolladores permiten que los usuarios del portal compartan la responsabilidad de una app con otros usuarios del portal. En las siguientes secciones, se describe cómo crear y administrar equipos de desarrolladores.

Punto clave: Los equipos de desarrolladores se denominan simplemente “equipos” cuando exploran el portal para desarrolladores.

Acerca de los roles del equipo de desarrolladores

En la siguiente tabla, se resumen los roles que se pueden asignar a los miembros del equipo de desarrolladores:

Nota: Como miembro del equipo de desarrolladores, puedes quitarte de cualquier equipo de desarrolladores, sin importar tu rol, a menos que seas propietario del equipo de desarrolladores.

Función	Descripción
Administrador de apps	Privilegios de solo lectura para los miembros del equipo de desarrolladores y los detalles del equipo de desarrolladores. Privilegios de lectura y escritura para apps.
Propietario	Privilegios completos de lectura y escritura para miembros del equipo de desarrolladores, detalles del equipo de desarrolladores y apps.
Lector	Privilegios de solo lectura para miembros del equipo de desarrolladores, detalles del equipo de desarrolladores y apps.

Ve la página Equipos

En la página Equipos, se muestran los equipos de desarrolladores de los que eres miembro.

Para acceder a la página Equipos, haz lo siguiente:

1. Accede al portal.
2. Selecciona Equipos en el menú desplegable de la cuenta de usuario en el portal.

Se muestra la página Equipos que te permite hacer lo siguiente:

• Visualizar los equipos de desarrolladores de los que eres miembro, incluidos el nombre, el rol, la lista de miembros y la fecha en que se creó el equipo
• Agregar un equipo de desarrolladores
• Editar la membresía y los roles del equipo de desarrolladores, quitarte de un equipo de desarrolladores o borrar un equipo si haces clic en la fila del equipo de desarrolladores

Agrega equipos de desarrolladores

Nota: En la página Equipos, los usuarios del portal pueden ver los equipos de desarrolladores de los que son miembros. Para la versión beta, no se envían notificaciones cuando se agrega un usuario del portal a un equipo de desarrolladores.

Para agregar un equipo de desarrolladores, haz lo siguiente:

1. Accede al portal.
2. Selecciona Equipos en el menú desplegable de la cuenta de usuario en el portal.
3. Haga clic en + Nuevo equipo.
4. Ingresa un nombre y una descripción.

5. Para agregar un miembro al equipo de desarrolladores, haz clic en + Agregar otro miembro, ingresa la dirección de correo electrónico del usuario del portal y selecciona un rol del equipo de desarrolladores.

   Repite el proceso para agregar miembros adicionales.

   Nota:

   • Se te agrega automáticamente como propietario del equipo de desarrolladores.
   • La cantidad máxima de equipos de desarrolladores de los que puede ser miembro un usuario es 16.

6. Para borrar un miembro del equipo de desarrolladores, haz clic en junto al miembro del equipo de desarrolladores que deseas borrar.

7. Haga clic en Crear.

Edita las membresías y los roles del equipo de desarrolladores

Para editar los roles y las membresías del equipo de desarrolladores, haz lo siguiente:

1. Accede al portal.
2. Selecciona Equipos en el menú desplegable de la cuenta de usuario en el portal.
3. Haz clic en la fila del equipo de desarrolladores que deseas editar y del que eres propietario.

4. Realiza una o más de las siguientes tareas:

   • Edita el nombre, la descripción y el contacto principal.
   • Agrega o quita miembros del equipo de desarrolladores.
   • Actualiza los roles de los miembros del equipo de desarrolladores.
     Nota:

     • Un equipo de desarrolladores debe tener al menos un propietario.
     • La cantidad máxima de equipos de desarrolladores de los que puede ser miembro un usuario es 16.

5. Haz clic en Guardar.

Quitarte de un equipo de desarrolladores

Nota: Como miembro del equipo de desarrolladores, puedes quitarte de cualquier equipo de desarrolladores, sin importar tu rol del equipo de desarrolladores, a menos que seas propietario del equipo de desarrolladores.

Para quitarte de un equipo de desarrolladores, haz lo siguiente:

1. Accede al portal.
2. Selecciona Equipos en el menú desplegable de la cuenta de usuario en el portal.
3. Haz clic en la fila del equipo de desarrolladores del que deseas quitarte tú mismo.
4. Haz clic en Salir del equipo.

Borra un equipo de desarrolladores

Nota: Cuando borras un equipo de desarrolladores, se borran todas las apps que pertenecen al equipo de desarrolladores.

Para borrar un equipo de desarrolladores, haz lo siguiente:

1. Accede al portal.
2. Selecciona Equipos en el menú desplegable de la cuenta de usuario en el portal.
3. Haz clic en la fila del equipo de desarrolladores que deseas borrar.
4. Haga clic en .
5. Haz clic en Confirmar para confirmar la eliminación.

Registra apps

Registra las apps de desarrolladores y las apps de equipos de desarrolladores, como se describe en las siguientes secciones.

Registra apps de desarrolladores

Punto clave: Después de que el usuario del portal registra una app de desarrollador, la información de la cuenta de usuario se sincroniza con Edge en la página del desarrollador. Consulta Dónde se almacena la información de la cuenta de desarrollador.

Los usuarios del portal pueden registrar aplicaciones para usar las API que publicaste, de la siguiente manera:

1. Selecciona Apps en el menú desplegable de la cuenta de desarrollador.
2. Haga clic en + App nueva para crear una nueva aplicación.
3. Ingresa un nombre y una descripción para la app en el cuadro de diálogo Nueva app.

4. En la sección Catálogo de API, selecciona una o más API.

   Las API del catálogo se clasifican como API autenticadas, que requieren una URL de devolución de llamada o API públicas. Debes seleccionar al menos una API para crear una app.

5. Si seleccionas una API en la sección API autenticadas, ingresa una URL de devolución de llamada.

   Para obtener más información, consulta Información acerca de las URL de devolución de llamada.

6. Haga clic en Crear.

Registra apps de equipos de desarrolladores

Nota: Este paso es válido solo si te inscribiste en la versión beta de la función de equipos. En la versión beta, la propiedad de la app no se puede transferir después de que se haya creado la app.

Los miembros del equipo de desarrolladores pueden registrar apps para que un equipo de desarrolladores use las API que publicas, como se describe a continuación.

Nota: Se agregará una nueva entidad de equipo de desarrolladores a Edge solo después de que un miembro registre una app para el equipo. Consulta Dónde se almacena la información del equipo de desarrolladores (beta).

Obtén más información acerca de los siguientes temas:

• Los usuarios del portal agregan y administran equipos, como se describe en Comparte la responsabilidad de una app con equipos de desarrolladores (beta).
• Los proveedores de API ven y administran equipos de desarrolladores, como se describe en Administra equipos de desarrolladores (beta).

Para registrar las apps de equipos de desarrolladores, haz lo siguiente:

1. Selecciona Apps en el menú desplegable de la cuenta de desarrollador.
2. Haz clic en la fila del equipo de desarrolladores para el que deseas registrar una app.
3. Haga clic en + App nueva para crear una nueva aplicación.
4. Ingresa un nombre y una descripción para la app en el cuadro de diálogo Nueva app.

5. Selecciona al propietario de la app en la lista desplegable Propietario.

   De forma predeterminada, el equipo de desarrolladores es el propietario de la app. Si lo deseas, selecciona un equipo de desarrolladores diferente o a ti mismo como propietario en el menú desplegable.

   Nota: En la versión beta, la propiedad de la app no se puede transferir después de que se haya creado la app.

6. En la sección Catálogo de API, selecciona una o más API.

   Las API del catálogo se clasifican como API autenticadas, que requieren una URL de devolución de llamada o API públicas. Debes seleccionar al menos una API para crear una app.

7. Si seleccionas una API en la sección API autenticadas, ingresa una URL de devolución de llamada.

   Para obtener más información, consulta Información acerca de las URL de devolución de llamada.

8. Haga clic en Crear.

Administra las API en una app

Como productor de API, publicas API para permitir que los usuarios del portal consuman tus productos de API.

Los usuarios del portal administran las API que usan sus apps. Las API se agregan a la página de detalles de la app. Para algunas API, la aprobación no es automática. Un estado de Aprobación pendiente indica una API para la que se solicitó acceso, pero que aún no se otorgó.

Nota: En este momento, no se muestran las API que no están publicadas. Este problema, se solucionará en una versión futura.

Si el usuario del portal inhabilita el acceso a una API privada o de uso interno, la API se quita de la app y el administrador del portal debe volver a agregarla de forma manual, como se describe en Controla el acceso a tus API mediante el registro de apps.

Los usuarios del portal pueden administrar las API en una app de tu portal de la siguiente manera:

1. Selecciona Apps en el menú desplegable de la cuenta de desarrollador.
2. Haz clic en la app de la lista.
3. En la sección de API, haz clic en o para habilitar o inhabilitar el acceso, respectivamente, a una API de la app.
4. Para una API autenticada, agrega o edita la URL de devolución de llamada, según sea necesario.

Visualiza el secreto y la clave de API de una app

Los usuarios del portal pueden administrar la clave de API de una app desde tu portal de la siguiente manera:

1. Selecciona Apps en el menú desplegable de la cuenta de desarrollador.
2. Haz clic en la app de la lista.
3. Consulta las claves de API en la sección Claves de API
4. Confirma que el estado de la clave de API esté activo.
   Si la clave de API requiere aprobación y todavía no se aprobó, el estado aparecerá como Aprobación pendiente.
5. Haz clic en Mostrar Secret para ver el Secret.
6. Coloca el cursor sobre la clave o el secreto de API y haz clic en para copiarlo en el portapapeles.

Nota: Si se desactivó o revocó la app o la cuenta de desarrollador, la clave de API no será válida hasta que se vuelva a activar y aprobar la app o la cuenta de desarrollador. Para obtener más información, consulta Activa y desactiva un desarrollador y Aprueba o revoca una app.

Rota la clave de API de una aplicación

El usuario de un portal 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 usuario del portal rota una clave de API, se crea una nueva clave de API con los mismos derechos de API que la clave original. La clave de API original permanece activa mientras la cambias sin su uso. Debes revocar la clave de API anterior para evitar que se acepten sus credenciales, como se describe en Revocar una clave de API para una app.

Los usuarios del portal pueden rotar una clave de API para una app de tu portal de la siguiente manera:

1. Selecciona Apps en el menú desplegable de la cuenta de desarrollador.
2. Haz clic en la app de la lista.
3. En la sección Claves de API, haz clic en Agregar clave.
4. Haz clic en Confirmar en el cuadro de diálogo para confirmar la operación.
5. De manera opcional, revoca la clave de API anterior, como se describe a continuación.

Revoca una clave de API para una app

Cuando un usuario de un portal rota una clave de API, como se describe en la sección anterior, la clave de API permanece activa mientras la cambias sin uso. Debes revocar una clave de API para evitar que se acepten sus credenciales.

Los usuarios del portal pueden revocar una clave de API para una app de tu portal de la siguiente manera:

1. Selecciona Apps en el menú desplegable de la cuenta de desarrollador.
2. Haz clic en el nombre de la app.
3. En la sección Claves de API, haz clic en en la columna Acciones asociada con la clave de API que deseas revocar.

4. Haz clic en Confirmar para confirmar la operación.

   El estado de la clave se actualiza a Revocada.

Edita los detalles de la aplicación

Los usuarios del portal pueden editar los detalles de la app de la siguiente manera:

1. Selecciona Apps en el menú desplegable de la cuenta de desarrollador.
2. Haz clic en la app de la lista.
3. Edita los campos Nombre o Descripción en la pestaña Detalles de la aplicación.
4. Administra las API en una app, según sea necesario.
5. Haz clic en Guardar.

Borra una app

Los usuarios del portal pueden borrar una app de tu portal de la siguiente manera:

1. Selecciona Apps en el menú desplegable de la cuenta de desarrollador.
2. Haz clic en la app de la lista.
3. Haz clic en BORRAR.
4. Haz clic en Confirmar para confirmar la operación.

La app se borra y se quita de la lista de apps.