Konfigurowanie uwierzytelniania OAuth-OSLC dla produktu Rational DOORS Web Access

W celu zapisania wartości właściwości base_url, consumer_key i secret należy utworzyć plik oslcServiceProviders.xml.

Zanim rozpoczniesz

O tym zadaniu

Domyślnie produkt odwołuje się do pliku oslcServiceProviders.xml w katalogu katalog_główny_RPE/config. Zaletą utworzenia pliku oslcServiceProviders.xml w tym katalogu domyślnym katalog_główny_RPE/config jest to, że nie jest potrzebna dalsza konfiguracja. Jednak należy pamiętać o konieczności utworzenia kopii zapasowej tego pliku przed przystąpieniem do aktualizacji produktu do nowszej wersji. Po przeprowadzeniu instalacji i aktualizacji można umieścić zapasowy plik oslcServiceProviders.xml w katalogu katalog_główny_RPE/config nowo zainstalowanego produktu.
Plik oslcServiceProviders.xml można umieścić poza domyślnym katalogiem katalog_główny_RPE/config, ale konieczne jest podanie położenia pliku oslcServiceProviders.xml we właściwości com.ibm.rational.rpe.config.oslcServiceProviders. Jeśli położenie to zabezpieczona ścieżka HTTP, należy określić referencje uwierzytelniające za pomocą właściwości com.ibm.rational.rpe.config.oslcServiceProviders.usr i com.ibm.rational.rpe.config.oslcServiceProviders.pwd. Te właściwości należy określić za pomocą jednego z następujących zasięgów:
  • Zmienne środowiskowe w danym systemie operacyjnym.
  • Właściwości Java wirtualnej maszyny języka Java (JVM).
  • Opcje w środowisku wykonawczym. Więcej informacji na temat ustawiania opcji dla serwerów WebSphere Application Server i Apache Tomcat oraz dla aplikacji klienckich znajduje się w poniższych sekcjach.

Tworzenie pliku oslcServiceProviders.xml poza domyślnym katalogiem RPE_HOME/config jest obsługiwane w środowiskach pracy grupowej. Plik oslcServiceProviders.xml może być ponownie wykorzystywany przez wielu użytkowników, jeśli jest umieszczony we współużytkowanym położeniu i jeśli jako wartość właściwości com.ibm.rational.rpe.config.oslcServiceProviders ustawiono to położenie.

Procedura

  1. Utwórz kopię przykładu w katalogu instalacyjnym produktu Rational Publishing Engine: RPE_HOME/config/oslcServiceProviders-sample.xml
  2. W edytorze tekstu otwórz własną kopię pliku oslcServiceProviders.xml.
  3. W znacznikach title podaj nazwę dostawcy źródła danych.
  4. W znacznikach description podaj opis lub uwagi dla dostawcy źródła danych.
  5. W znacznikach base_url podaj podstawowy adres URL do źródła danych.

    Aby zidentyfikować adres URL w kliencie Rational DOORS, należy kliknąć prawym przyciskiem myszy adres URL obiektu w otwartym module i kliknąć opcję Kopiuj adres URL.

    Aby zidentyfikować adres URL w produkcie Rational DOORS Web Access, należy przejść do widoku Eksplorator bazy danych, otworzyć moduł i wybrać obiekt. W sekcji Atrybuty > Systemy należy skopiować wartość znajdującą się w polu Adres URL. W tym celu należy na przykład kliknąć prawym przyciskiem myszy pole Adres URL i wybrać opcję menu Kopiuj skrót.

    Przykład: https://serwer:port/dwa

  6. W znacznikach pattern podaj wzorzec adresu URL źródła danych. Zwykle znaczniki base_url i pattern zawierają ten sam adres URL źródła danych produktu Rational DOORS Web Access. Jeśli lista źródeł danych jest dostępna w pliku oslcServiceProviders.xml, wzorzec jest używany do określenia, które szczegóły źródła danych są zgodne z wymaganiami dotyczącymi źródła danych.

    Przykład: https://serwer:port/dwa

  7. W znacznikach consumer_key podaj klucz konsumenta ze źródła danych.

    Aby zidentyfikować wartość consumer_key w produkcie Rational DOORS, należy kliknąć opcję Plik > OSLC > Klucze lokalne.

  8. W znacznikach secret podaj wartość klucza tajnego ze źródła danych.

    Aby zidentyfikować wartość secret, w produkcie Rational DOORS należy kliknąć opcję Plik > OSLC > Klucze lokalne. Następnie należy znaleźć pole Klucz tajny OAuth. Wartość Klucz tajny OAuth to wartość, jaką należy wprowadzić we właściwości secret produktu Rational Publishing Engine.

  9. Zapisz plik oslcServiceProviders.xml w innym miejscu niż katalog instalacyjny produktu Rational Publishing Engine.