Usa credenciales federadas en el portal para desarrolladores

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

El acceso federado es el proceso en el que usas credenciales de un sistema de administración de identidades, llamado sistema de registro, para acceder a otro sistema. Por ejemplo, usa tus credenciales de Google o Twitter a fin de acceder al portal para desarrolladores de Apigee. La ventaja del acceso federado es que el sistema al que accedes nunca ve la contraseña asociada con tus credenciales. Eso significa que no es necesario copiar tus contraseñas en diferentes sistemas.

El portal de Servicios para desarrolladores admite el acceso federado mediante credenciales de varios proveedores comunes, incluidos los siguientes:

  • GitHub
  • Servicios
  • OpenID
  • Twitter

Además, si ya tienes una cuenta de Apigee Edge, puedes usar esas credenciales a fin de acceder al portal para desarrolladores.

Cada uno de los proveedores de credenciales admitidos requiere un proceso de configuración diferente, como se describe a continuación.

Usa credenciales federadas con el portal para desarrolladores

Para obtener acceso al portal, un desarrollador registra una cuenta nueva y especifica un nombre de usuario, una dirección de correo electrónico y una contraseña. Luego, el usuario puede acceder al portal proporcionando su nombre de usuario y contraseña como credenciales.

Con el acceso federado en el portal, puedes usar credenciales de un tercero para acceder a una cuenta existente en el portal. Es decir, necesitas una cuenta en el portal para poder acceder con credenciales de terceros. Puedes usar cualquiera de las credenciales federadas compatibles con Apigee para acceder a una cuenta existente del portal. Además, puedes usar las credenciales de Google y Apigee para registrar una cuenta nueva en el portal.

Cómo acceder a una cuenta existente del portal

Accede a una cuenta existente en el portal con cualquiera de las credenciales federadas compatibles. Por ejemplo, accede con tus credenciales de Twitter. La primera vez que accedes con tus credenciales de Twitter, el portal te solicita que asocies tus credenciales de Twitter con una cuenta existente del portal. Solo debes realizar esta asociación una vez. Después de eso, podrás acceder con tus credenciales de Twitter y el portal conservará la información de la asociación.

Registra una cuenta nueva en el portal

Registra una cuenta nueva en el portal con tus credenciales de Google o Apigee. Cuando te registras como desarrollador nuevo en el portal con credenciales federadas, el portal para desarrolladores intenta obtener información (por lo general, la dirección de correo electrónico) desde el sistema de registro. Por ejemplo, usa tus credenciales de Google para crear una cuenta de desarrollador nueva en el portal. Se te solicitará que apruebes la información que Google envía al portal. Incluso si el sistema de registro devuelve información al portal, por lo general, se requieren registros nuevos para ingresar cierta información, como la aceptación de los Términos y Condiciones.

Regístrate o accede con credenciales de Apigee

Si ya tienes una cuenta de Apigee Edge, puedes usar esas credenciales para registrar una cuenta o acceder a una cuenta existente en el portal para desarrolladores. De forma predeterminada, aparece el siguiente botón en las páginas de registro y de acceso del portal para desarrolladores:

El botón solo aparece en portales con una URL que termina en apigee.com, es decir, portales en el dominio de Apigee. Por ejemplo, una URL con el formato http://myCompany.devportal.apigee.com. Si la URL no termina con ese dominio, no puedes usar tus credenciales de Apigee Edge para acceder al portal o registrarte en él.

Para registrar a un usuario existente de Apigee Edge como desarrollador nuevo del portal, haz lo siguiente:

Nota: En el proceso de registro, se da por sentado que tienes tu portal configurado para permitir que cualquier persona se registre sin la aprobación del administrador. Consulta Cómo agregar y administrar cuentas de usuario para obtener más información sobre cómo controlar quién puede registrarse.

  1. Asegúrate de tener una cuenta de Apigee Edge existente.
  2. Selecciona el vínculo de registro en el portal para desarrolladores.
  3. Selecciona el botón Autenticar con Apigee en la página de registro.
    • Si no accediste a Apigee Edge, ingresa tus credenciales del servicio y selecciona Acceder.
  4. Si no se requiere ninguna otra información para registrarte, accederás al portal para desarrolladores con tu cuenta nueva.
    Recibirás un mensaje en la dirección de correo electrónico asociada a tu cuenta de Apigee con información para completar el proceso de registro, como la configuración de tu contraseña.
  5. Si se requiere información adicional para completar el proceso de registro, como la aceptación de los términos y condiciones, se te redireccionará automáticamente a la página de registro con el nombre de usuario y la información de correo electrónico de tu cuenta de Apigee Edge ingresados en los campos correspondientes.
  6. Especifica cualquier otra información de registro requerida para completar el proceso de registro.
  7. Selecciona Crear una cuenta nueva.
    Recibirás un mensaje en la dirección de correo electrónico asociada a tu cuenta de Apigee con información para completar el proceso de registro, como la configuración de tu contraseña.

Sigue estos pasos para acceder como desarrollador existente del portal mediante una cuenta de Apigee:

  1. Selecciona el vínculo de acceso en el portal para desarrolladores.
  2. Selecciona el botón Autenticar con Apigee en la página de acceso.
    • Si ya accediste a Apigee Edge, accederás automáticamente al portal para desarrolladores.
    • Si no accediste a Apigee Edge, ingresa tus credenciales del servicio y selecciona Acceder.

Regístrate o accede con las credenciales de Google

El registro federado y el acceso con las credenciales de Google están habilitados en el portal para desarrolladores de forma predeterminada. Tanto en la página de registro como en la de acceso, verás el siguiente botón:

Puedes registrarte como desarrollador nuevo o acceder como un desarrollador existente con tus credenciales de Google. Por ejemplo, si tienes una cuenta de Gmail, puedes acceder con las credenciales de ese servicio.

El portal para desarrolladores asocia las credenciales de Google con la cuenta del portal mediante el almacenamiento de un OpenID de Google en el perfil del portal. Después de asociar las credenciales de Google con la cuenta del portal, podrás ver el OpenID si seleccionas tu dirección de correo electrónico > Editar perfil en el menú de nivel superior del portal para desarrolladores y, luego, haz clic en Manage your OpenIDs.

Sigue estos pasos para registrarte como desarrollador nuevo con tus credenciales de Google:

Nota: En el proceso de registro, se da por sentado que tienes tu portal configurado para permitir que cualquier persona se registre sin la aprobación del administrador. Consulta Cómo agregar y administrar cuentas de usuario para obtener más información sobre cómo controlar quién puede registrarse.

  1. Asegúrate de tener una Cuenta de Google existente, como una de Gmail.
  2. Seleccionar el vínculo Registrar en el portal para desarrolladores
  3. Selecciona el botón Autenticar con Google en la página de registro.
    Se te dirigirá a una página de Google en la que se te solicitará que aceptes que el portal para desarrolladores pueda acceder a tu dirección de correo electrónico de Google y a tu información básica.
  4. Selecciona Aceptar para aprobarla.
  5. Se te redireccionará a la página de registro del portal para desarrolladores, con la información de Google prepropagando los campos de registro.
  6. Especifica la información requerida que falte para completar el proceso de registro.
  7. Selecciona Crear una cuenta nueva.
    Recibirás un correo electrónico en tu cuenta de Gmail con información para completar el proceso de registro.

Para acceder como desarrollador existente, sigue estos pasos:

  1. Selecciona el vínculo de acceso en el portal para desarrolladores.
  2. Selecciona el botón Autenticar con Google en la página de acceso.
    • Si ya accediste a Google, también accederás al portal.
    • Si no accediste a Google, ingresa tus credenciales de Google para acceder al portal.
  3. Si es la primera vez que accedes con las credenciales de Google, se te redireccionará a una página en el portal en la que deberás asociar tu Cuenta de Google con una cuenta existente en el portal para desarrolladores:

  4. Copia la URL que aparece en tu OpenID.
  5. Selecciona el vínculo de acceso en la parte superior de la página y accede con las credenciales existentes del portal para desarrolladores.
  6. Selecciona tu dirección de correo electrónico > Edit Profile en el menú de nivel superior del portal para desarrolladores.
  7. En la página de tu perfil, selecciona Administrar tus OpenIDs.
  8. Ingresa la URL de OpenID y selecciona Agregar OpenID.
    Ahora puedes acceder con tus credenciales de Google.

Accede con credenciales de Twitter

Puedes acceder como desarrollador existente con tus credenciales de Twitter, pero no puedes registrarte como usuario nuevo.

El acceso federado con credenciales de Twitter requiere que habilites el módulo de Acceso con Twitter de Drupal en el portal para desarrolladores. Después de habilitar ese módulo, verás el siguiente botón en la página de acceso:

La conexión entre el portal para desarrolladores y Twitter usa OAuth para la autenticación. Por lo tanto, antes de poder acceder al portal para desarrolladores con las credenciales de Twitter, primero debes crear una app de Twitter. Luego, esa app genera la clave y el secreto de consumidor que usan el portal para desarrolladores y Twitter para comunicarse.

En el siguiente proceso, primero debes habilitar el módulo de acceso con Twitter en el portal para desarrolladores y, luego, crear la app de Twitter. Después de crear la app, regresa al módulo de acceso con Twitter y agrega la información de configuración requerida de la app de Twitter.

Sigue estos pasos para habilitar el módulo de Acceso con Twitter:

  1. Accede a tu portal como un usuario con privilegios de administrador.
  2. En el menú de administración de Drupal, seleccione Modules. Aparecerá la lista de todos los módulos instalados de Drupal.
  3. Desplázate hacia abajo en la página y selecciona la casilla de verificación junto al módulo de Acceso con Twitter.
  4. Guarda la configuración.
    Cuando habilites el módulo de acceso con Twitter, es posible que se te notifique que también se deben habilitar otros módulos. Asegúrate de habilitarlos.
  5. Después de habilitar el módulo de acceso con Twitter, selecciona Configuración > Servicios web > Twitter en el menú de Drupal.
    Aparecerá la pantalla de configuración de Twitter.
  6. Seleccione la pestaña Configuración.
  7. Copia la URL de devolución de llamada. Esta es una URL con el formato:

    http://{env}-{org-name}.devportal.apigee.com/twitter/oauth

    Necesitas esta URL para crear la app de Twitter.

Crea la app de Twitter:

  1. Navega a esta página en un navegador: https://dev.twitter.com/apps/new y accede a tu cuenta de Twitter.
  2. Ingresa la siguiente información sobre tu portal:
    Nombre: por ejemplo MyApigeePortal
    Descripción: por ejemplo, el portal de Mi Apigee
    Sitio web: por ejemplo http://{env}-{org-name}.devportal.apigee.com/
    CallbackURL: Copia la URL de devolución de llamada desde la pantalla de configuración del módulo de acceso con Twitter.
  3. Acepta los términos y condiciones.
    Se te redireccionará a una página de Twitter con la configuración de OAuth, que incluye la clave y el secreto del consumidor. Necesitas la clave y el secreto para configurar el módulo de acceso de Drupal con Twitter.
  4. En la pestaña Configuración, cambia el Acceso al tipo de aplicación a lectura y escritura.
  5. Selecciona Actualizar la configuración de esta aplicación de Twitter.

Para configurar el módulo de Acceso con Twitter, haz lo siguiente:

  1. Accede a tu portal como un usuario con privilegios de administrador.
  2. Selecciona Configuración > Servicios web > Twitter en el menú de Drupal.
    Aparecerá la pantalla de configuración de Twitter.
  3. Seleccione la pestaña Configuración.
  4. Copia la clave de consumidor de la página de Twitter en el campo Clave de consumidor de OAuth.
  5. Copia el Secreto de consumidor de la página de Twitter en el campo Secreto del consumidor de OAUTH.
  6. Selecciona Guardar configuración.
  7. Selecciona la pestaña Twitter.
  8. Mientras estés conectado a Twitter con la cuenta que crea la app de Twitter, selecciona el botón Ir a Twitter para agregar una cuenta autenticada.
  9. Selecciona la pestaña Acceso.
  10. Selecciona No en Registrar usuarios nuevos automáticamente.
  11. Guarde la configuración.
    Los usuarios de Twitter ahora pueden registrarse en el portal para desarrolladores y acceder con sus credenciales de Twitter.

Para acceder como desarrollador existente con una cuenta de Twitter, haz lo siguiente:

  1. Selecciona el vínculo de acceso en el portal para desarrolladores.
  2. Selecciona el botón Autenticar con Twitter en la página de acceso.
  3. Se te redireccionará a una página de Twitter.
    • Si ya accediste a Twitter, selecciona Autorizar aplicación.
    • Si aún no accediste a Twitter, ingresa tus credenciales de Twitter y selecciona Autorizar app.
  4. Si es la primera vez que accedes con las credenciales de Twitter, se te redireccionará a una página en el portal en la que deberás asociar tu cuenta de Twitter con una cuenta existente en el portal para desarrolladores.
  5. Ingresa el nombre de usuario y la contraseña de la cuenta que deseas asociar con tu cuenta de Twitter. Solo tienes que hacerlo una vez.
    La próxima vez que accedas con tus credenciales de Twitter, accederás directamente al portal.

Accede con credenciales de GitHub

Puedes acceder como desarrollador existente mediante tus credenciales de GitHub, pero no puedes registrarte como usuario nuevo.

El acceso federado con credenciales de GitHub requiere que habilites el módulo GitHub Connect de Drupal en el portal para desarrolladores. Después de habilitar ese módulo, verás el siguiente botón en la página de acceso:

La conexión entre el portal para desarrolladores y GitHub usa OAuth para la autenticación. Por lo tanto, antes de poder acceder al portal para desarrolladores con las credenciales de GitHub, primero debes crear una app de GitHub. Luego, esa app generará la clave y el secreto de consumidor que usan el portal para desarrolladores y GitHub para comunicarse.

En el siguiente proceso, primero debes crear la app de GitHub. Después de crear la app, habilita el módulo de conexión de GitHub y agrega el ID de cliente y el secreto del cliente desde la app de GitHub.

Crea la app de GitHub:

  1. Navega a esta página en un navegador: https://github.com/settings/applications/new y, si es necesario, accede a tu cuenta de GitHub.
  2. Ingresa la siguiente información sobre tu portal:
    Nombre de la aplicación: por ejemplo, MyApigeePortal
    Descripción: por ejemplo, el portal de Mi Apigee
    Sitio web: por ejemplo: http://{env}-{org-name}.devportal.apigee.com/
    CallbackURL: La URL de la página principal de tu portal, con la extensión /github/register/create. Por ejemplo:

    http://{env}-{org-name}.devportal.apigee.com/github/register/create
  3. De manera opcional, elige una imagen.
  4. Selecciona Registrar aplicación. En el sitio de GitHub, se muestra el ID de cliente y el secreto de cliente que necesitas para configurar el módulo de conexión de GitHub en el portal para desarrolladores con el siguiente formato:
    ID de cliente: dbe86111e411d031d8fb
    Secreto de cliente: e6bd0f838a288113e8b4e531cb6a9487c927f27
  5. Copia estos valores para usarlos cuando configures el módulo de conexión de GitHub.

Para habilitar el módulo Conexión de GitHub, haz lo siguiente:

  1. Accede a tu portal como un usuario con privilegios de administrador.
  2. En el menú de administración de Drupal, seleccione Modules. Aparecerá la lista de todos los módulos instalados de Drupal.
  3. Desplázate hacia abajo en la página y selecciona la casilla de verificación junto al módulo Conexión de GitHub.
  4. Guarda la configuración.
    Cuando habilitas el módulo de conexión de GitHub, es posible que se te notifique que también se deben habilitar otros módulos. Deberían habilitarse automáticamente.
  5. Después de habilitar el módulo de conexión de GitHub, selecciona Configuración > Personas > GitHub en el menú de Drupal.
    Aparecerá la pantalla de configuración de GitHub.
  6. Ingresa el ID de cliente y el secreto del cliente de tu aplicación de GitHub.
  7. Coloca el bloque de GitHub Connect donde desees que se muestre.
  8. Guarde la configuración.

Para acceder como desarrollador existente con una cuenta de GitHub, sigue estos pasos:

  1. Selecciona el vínculo de acceso en el portal para desarrolladores.
  2. Selecciona el botón Acceder con GitHub en la página de acceso.
  3. Se te redireccionará a una página de GitHub.
    • Si ya accediste a GitHub, selecciona Permitir acceso.
    • Si aún no accediste a GitHub, ingresa tus credenciales de GitHub y selecciona Autorizar app.
  4. Si es la primera vez que accedes con las credenciales de GitHub, se te redireccionará a una página en el portal en la que deberás asociar tu cuenta de GitHub con una cuenta existente en el portal para desarrolladores.
  5. Ingresa el nombre de usuario y la contraseña de la cuenta que deseas asociar con tu cuenta de GitHub. Solo tienes que hacerlo una vez.
    La próxima vez que accedas con tus credenciales de GitHub, accederás directamente al portal.

Accede con credenciales de OpenID

OpenID te permite crear un nombre de usuario y una contraseña únicos que puedes usar para acceder a cualquier sitio que admita OpenID. Con OpenID, tu contraseña no se comparte, sino que reside solo con el proveedor de OpenID. Depende del proveedor de OpenID verificar tu identidad en otro sitio web. Para obtener más información sobre OpenID, consulta http://openid.net/.

Si tienes cuentas en algunos de los sitios web más populares, como Google o Yahoo, ya tienes un OpenID. Por ejemplo, un usuario de correo electrónico de Yahoo tiene un OpenID en el siguiente formato:

https://me.yahoo.com/a/UniqueID

en el que Yahoo genera UniqueID. Puedes usar este OpenID a fin de acceder al portal para desarrolladores.

Para admitir OpenID con el portal para desarrolladores, debes habilitar el módulo OpenID de Drupal. No se requiere ninguna otra configuración en el portal para desarrolladores. Después de habilitar el módulo de OpenID, se agregan automáticamente los siguientes vínculos a la página de acceso del portal para desarrolladores:

El portal para desarrolladores asocia un OpenID a tu cuenta del portal mediante el almacenamiento de este en tu perfil del portal. Después de asociar un OpenID a tu cuenta del portal, para verlo, selecciona tu dirección de correo electrónico > Editar perfil en el menú de nivel superior del portal para desarrolladores y, luego, haz clic en Manage your OpenIDs.

Para habilitar el módulo OpenID, haz lo siguiente:

  1. Accede a tu portal como un usuario con privilegios de administrador.
  2. En el menú de administración de Drupal, seleccione Modules. Aparecerá la lista de todos los módulos instalados de Drupal.
  3. Desplázate hacia abajo en la página y selecciona la casilla de verificación junto al módulo de OpenID.
  4. Guarda la configuración.
    No se requiere ninguna otra configuración en el portal para desarrolladores.

Para acceder como desarrollador existente mediante un OpenID, sigue estos pasos:

  1. Accede al portal para desarrolladores con tus credenciales para desarrolladores.
  2. Selecciona tu dirección de correo electrónico > Editar perfil en el menú principal de la barra de menú.
  3. En la página de tu perfil, selecciona Administrar tus OpenIDs.
  4. Ingresa tu OpenID y selecciona Agregar un OpenID.
    Ahora puedes acceder con tu OpenID.
  5. Sal del portal para desarrolladores.
  6. Selecciona Acceso.
  7. En la página de acceso, selecciona Acceder con OpenID.
  8. Ingresa tu OpenID.
  9. Selecciona Acceder.

Como alternativa, puedes acceder directamente a una cuenta existente del portal para desarrolladores con tu OpenID. Cuando lo hagas por primera vez, se te pedirá que accedas con tus credenciales del portal para desarrolladores. Cuando accedes por primera vez, se asocia automáticamente tu OpenID con la cuenta del portal para desarrolladores. Ahora puedes acceder directamente con tu OpenID.