Especificando o tipo de autenticação para uma origem de dados em uma especificação do documento

Quando uma origem de dados requer autenticação, cada tipo de autenticação suportado pelo Rational Publishing Engine (Form, Basic, OAuth ou OAuth-OSLC) é testado até que o tipo correto seja localizado. Você pode contornar o processo de teste designando um tipo de autenticação.

Quando você especifica o tipo de autenticação, Rational Publishing Engine assegura que o protocolo correto seja usado primeiro e solicitações desnecessárias não sejam executadas. Você pode ver uma melhoria de desempenho significativa no tempo de geração de documento se sua origem de dados exigir autenticação Basic, OAuth ou OAuth-OSLC ou se você estiver usando um modelo complexo que requeira muitas solicitações da origem de dados. Se nenhum tipo de autenticação for especificado, cada tipo será testado.

Sobre Esta Tarefa

Para obter informações adicionais sobre como nomes de usuário e senhas são armazenados, veja Considerações sobre segurança do IBM® Rational Publishing Engine.

Procedimento

  1. Abra o aplicativo Launcher.
  2. Crie uma especificação de documento.
  3. Configure uma origem de dados.
  4. Selecione a origem de dados. A visualização Propriedades é aberta.
  5. No campo autenticação, insira o tipo de autenticação que se aplica à sua origem de dados. É possível inserir um dos seguintes tipos de autenticação com distinção entre maiúsculas e minúsculas:
    • Form
    • Basic
    • OAuth
    • OAuth-OSLC
  6. Se necessário, insira as credenciais para autenticar com a origem de dados incluindo o nome de usuário e senha.
  7. Salve a especificação do documento.

O que Fazer Depois

Atualize as propriedades de autenticação em especificações de documentos existentes.

Criando arquivo oslcServiceProviders.xml para autenticação OAuth-OSLC

Se você estiver usando uma origem de dados XML, REST v1 ou REST v2 que requer autenticação OAuth-OSLC, deverá primeiro criar um oslcServiceProviders.xml para armazenar os valores de propriedades base_url, consumer_key e secret.

Sobre Esta Tarefa

Por padrão, o produto procurará pelo arquivo oslcServiceProviders.xml sob o diretório RPE_HOME/config. O benefício de criar o arquivo oslcServiceProviders.xml neste diretório padrão RPE_HOME/config é que nenhuma outra configuração é necessária. No entanto, você deve se lembrar de criar um backup desse arquivo quando desejar atualizar para uma versão mais recente do produto. Após a instalação e upgrade, você pode colocar o arquivo de backup oslcServiceProviders.xml no diretório RPE_HOME/config do produto recentemente instalado.
É possível especificar o arquivo oslcServiceProviders.xml fora do diretório padrão RPE_HOME/config, mas você deve especificar o local do arquivo oslcServiceProviders.xml com a propriedade com.ibm.rational.rpe.config.oslcServiceProviders. Se o local for um caminho seguro HTTP, você deverá especificar as credenciais de autenticação com as propriedades com.ibm.rational.rpe.config.oslcServiceProviders.usr e com.ibm.rational.rpe.config.oslcServiceProviders.pwd. Especifique essas propriedades usando um dos seguintes escopos:
  • Variáveis de ambiente em seu sistema operacional
  • Propriedades Java em sua Java virtual machine (JVM)
  • Os sinalizadores em seu ambiente de tempo de execução. Consulte um dos seguintes tópicos para obter mais informações sobre como configurar sinalizadores para WebSphere Application Server, Apache Tomcat ou aplicativos clientes

A criação do arquivo oslcServiceProviders.xml fora do diretório padrão RPE_HOME/config suporta ambientes de colaboração de equipe. O arquivo oslcServiceProviders.xml pode ser reutilizado por vários usuários ao colocar o arquivo em um local compartilhado, e configurar a propriedade com.ibm.rational.rpe.config.oslcServiceProviders para apontar para o local compartilhado.

Procedimento

  1. Crie uma cópia da amostra no diretório de instalação do Rational Publishing Engine: RPE_HOME/config/oslcServiceProviders-sample.xml
  2. Em um editor de texto, abra sua cópia do arquivo oslcServiceProviders.xml.
  3. Nas identificações title, forneça um nome para o provedor de origem de dados.
  4. Nas identificações description, forneça uma descrição ou notas para o provedor de origem de dados.
  5. Nas identificações base_url, forneça a URL base para a origem de dados. Exemplo: https://server:port/oslcCatalog
  6. Nas identificações pattern, forneça o padrão de URL da origem de dados. Quando você tiver uma lista de origens de dados especificadas no arquivo oslcServiceProviders.xml, o padrão será usado para identificar quais detalhes da origem de dados correspondem aos requisitos da origem de dados. Exemplo: https://server:port/contextroot
  7. Nas identificações consumer_key, forneça a chave do consumidor da origem de dados.
  8. Nas identificações secret, forneça o valor secreto da origem de dados.
  9. Salve o arquivo oslcServiceProviders.xml para um local fora do diretório de instalação do Rational Publishing Engine.