Especificar el tipo de autenticación para un origen de datos en una especificación de documento

Cuando un origen de datos requiere autenticación, se prueba cada tipo de autenticación soportado por Rational Publishing Engine (Formulario, Básica, OAuth o OAuth-OSLC) hasta encontrar el tipo correcto. Puede eludir el proceso de prueba designando un tipo de autenticación.

Cuando se especifica el tipo de autenticación, Rational Publishing Engine se asegura de que el protocolo correcto se utilice en primer lugar y no se realicen solicitudes innecesarias. Puede observar una mejora de rendimiento significativa en tiempo de generación de documentos si el origen de datos requiere autenticación Básica, OAuth o OAuth-OSLC o si está utilizando una plantilla compleja que requiere muchas peticiones del origen de datos. Si no se especifica ningún tipo de autenticación, se prueba cada uno de los tipos.

Acerca de esta tarea

Para obtener más información sobre cómo se almacenan los nombres de usuario y contraseñas, consulte Consideraciones de seguridad para IBM® Rational Publishing Engine.

Procedimiento

  1. Abra la aplicación Lanzador.
  2. Cree una especificación de documento.
  3. Configure un origen de datos.
  4. Seleccione el origen de datos. Se abrirá la vista Propiedades.
  5. En el campo Autenticación, escriba el tipo de autenticación que se aplica a su origen de datos. Puede especificar uno de los siguientes tipos de autenticación sensibles a mayúsculas y minúsculas:
    • Formulario
    • Básica
    • OAuth
    • OAuth-OSLC
  6. Si es necesario, especifique las credenciales para realizar la autenticación en el origen de datos, incluyendo el nombre de usuario y la contraseña.
  7. Guarde la especificación de documento.

Qué hacer a continuación

Actualice las propiedades de autenticación en las especificaciones de documento existentes.

Crear el archivo oslcServiceProviders.xml para la autenticación OAuth-OSLC

Si está utilizando un origen de datos XML genérico, REST v1 o REST v2 que requiere autenticación OAuth-OSLC, primero debe crear un archivo oslcServiceProviders.xml para almacenar los valores de las propiedades url_base, clave_consumidor y secreto.

Acerca de esta tarea

De forma predeterminada, el producto busca el archivo oslcServiceProviders.xml en el directorio RPE_HOME/config. La ventaja de crear el archivo oslcServiceProviders.xml bajo este directorio RPE_HOME/config predeterminado es que no se necesita ninguna configuración adicional. Sin embargo, debe recordar crear una copia de seguridad de este archivo si desea actualizar a una versión posterior del producto. Después de la instalación y actualización, puede colocar la copia de seguridad del archivo oslcServiceProviders.xml en el directorio RPE_HOME/config del producto recién instalado.
Puede especificar el archivo oslcServiceProviders.xml fuera del directorio RPE_HOME/config predeterminado, pero debe especificar la ubicación del archivo oslcServiceProviders.xml con la propiedad com.ibm.rational.rpe.config.oslcServiceProviders. Si la ubicación es una vía de acceso protegida HTTP, debe especificar las credenciales de autenticación con las propiedades com.ibm.rational.rpe.config.oslcServiceProviders.usr y com.ibm.rational.rpe.config.oslcServiceProviders.pwd. Especifique estas propiedades utilizando uno de los siguientes ámbitos:
  • Variables de entorno en el sistema operativo
  • Propiedades Java en la máquina virtual Java (JVM)
  • Distintivos en el entorno de ejecución. Consulte uno de los temas siguientes para obtener más información sobre cómo configurar distintivos para WebSphere Application Server, Apache Tomcat o las aplicaciones cliente

La creación del archivo oslcServiceProviders.xml fuera del directorio RPE_HOME/config predeterminado da soporte a entornos de colaboración en equipo. Varios usuarios pueden reutilizar el archivo oslcServiceProviders.xml si se coloca el archivo en una ubicación compartida y se establece la propiedad com.ibm.rational.rpe.config.oslcServiceProviders para que apunte a la ubicación compartida.

Procedimiento

  1. Cree una copia del ejemplo en el directorio de instalación de Rational Publishing Engine: RPE_HOME/config/oslcServiceProviders-sample.xml
  2. En un editor de texto, abra la copia del archivo oslcServiceProviders.xml.
  3. En las etiquetas título, proporcione un nombre para el proveedor de origen de datos.
  4. En las etiquetas descripción, proporcione una descripción o notas para el proveedor de origen de datos.
  5. En las etiquetas url_base, proporcione el URL base para el origen de datos. Ejemplo: https://servidor:puerto/oslcCatalog
  6. En las etiquetas patrón, proporcione el patrón de URL del origen de datos. Cuando hay una lista de orígenes de datos especificados en el archivo oslcServiceProviders.xml, el patrón se utiliza para identificar los detalles del origen de datos que coinciden con los requisitos de origen de datos. Ejemplo: https://servidor:puerto/contextroot
  7. En las etiquetas clave_consumidor, proporcione la clave de consumidor del origen de datos.
  8. En las etiquetas secreto, proporcione el valor de secreto del origen de datos.
  9. Guarde el archivo oslcServiceProviders.xml en una ubicación fuera del directorio de instalación de Rational Publishing Engine.