機械翻訳について

Oracle Content Management REST APIへの接続

アイデンティティ伝播または固定資格証明を使用して、Oracle Content Management REST APIに接続できます。

アイデンティティ伝播を使用したOracle Content Management REST APIへの接続

Oracle Content ManagementとVisual Builderは一緒にプロビジョニングされないため、サービス管理者は、IDCSで次のステップを実行して、Visual BuilderアプリケーションのリソースとしてOracle Content Managementを追加する必要があります。

これにより、Oracle Content Managementが特定のアプリケーションにリソースとして追加されるため、管理者は、新しいVisual Builderアプリケーションごとに、また、アイデンティティ伝播を使用してOracle Content Managementに接続するアプリケーションの新しいバージョンおよび複製ごとに、これらのステップを再度実行する必要があります。

  1. IDCSのVisual Builderアプリケーションの「構成」タブで、「クライアント構成」パネルを展開し、「トークン発行ポリシー」セクションの「スコープの追加」をクリックします。
  2. 「スコープの選択」ダイアログ・ボックスで、Oracle Content Managementインスタンスの/documents"エンドポイントに対応するスコープを選択し、アプリケーションを保存します。 これで、追加したスコープがリソース・リストのアプリケーションに表示されます。

    他のOracle Content Management機能(ソーシャルなど)が必要な場合は、対応するスコープを追加する必要があります。

管理者がIDCSにリソースを追加した後、アイデンティティ伝播を使用してOracle Content Managementへの接続を作成できます。 IDCSへのアクセス権がない場合は、管理者が認証タブに入力する必要があるOracle Content Managementスコープを提供する必要があります。

サービス接続を作成する場合は、サービス接続に次の認証メソッドを使用します:

認証方式 詳細
OAuth 2.0 User Assertion

このオプションを使用するには、次の詳細を指定する必要があります:

  • クライアントID機密: 空白のままにします。
  • トークンURL: 空白のままにします。
  • スコープ: Oracle Content Managementインスタンスに対応するIDCSから追加されたスコープ。 これは、"/documents"を含む完全な範囲です。

Oracle Content Managementに接続するには:

  1. ナビゲータでサービスを開き、+記号をクリックして「サービス接続」を選択します。
  2. サービス接続の作成ウィザードのソースの選択ステップで「エンドポイントで定義」をクリックします。
  3. HTTPメソッドを選択し、Oracle Content ManagementエンドポイントのURLを入力します。
    たとえば、エンドポイントのURLは次のようになります : https://<Oracle_Content_Management_instance>/documents/api/<VERSION>/folders/{folderId}
  4. 「サーバー」タブの「認証」セクションで、認証メソッドとして「OAuth 2.0ユーザー・アサーション」を選択します。
  5. 「スコープ」フィールドに、IDCSで追加されたOracle Content Managementインスタンスに対応するスコープを入力します。
    「クライアントID」「シークレット」および「トークンURL」フィールドは空白です。
  6. サービス接続をテストします。
  7. オプショナル: アプリの匿名ユーザーがサービス接続にアクセスできるようにする場合は、「サーバー」タブから呼び出す「サーバーの編集」ダイアログでサービス接続インフラストラクチャへの匿名アクセスを許可チェックボックスを選択します。 「匿名ユーザーの認証」ドロップダウン・リストを使用して、匿名ユーザーの認証タイプを構成します。

固定資格証明を使用したOracle Content Management REST APIへの接続

固定資格証明を使用してOracle Content Managementに接続するには、Oracle Content ManagementインスタンスとVisual Builderインスタンスを同じドメインに配置したり、同じIDCSインスタンスによって管理する必要はありません。 サービス接続には、基本認証またはOAuth 2.0リソース所有者パスワード認証を使用できます。

Oracle Content Managementへの接続にBasic認証を使用する場合は、IDCSで有効なユーザー名とパスワードを指定する必要があります。

Oracle Content Managementへの接続を認証するためにOAuthフローを使用する場合は、アクセスするスコープに関連付けられたクライアント・シークレット、クライアントIDおよびURLの詳細を取得する必要があります。 通常、アクセスするスコープは/documents"ですが、他のOracle Content Management機能(ソーシャルなど)にアクセスする場合は、そのスコープに対応するURLが必要です。 Oracle Content Managementで使用されるIDCSインスタンスへのアクセス権がない場合は、インスタンスへのアクセス権を持つユーザーから詳細をリクエストする必要があります。

IDCSからOracle Content Managementアプリケーションの詳細を取得するには:

  1. Oracle Content Managementインスタンスを表すIDCSのOracle Content Managementアプリケーションの「構成」タブで、「一般情報」パネルを展開し、「クライアントID」および「クライアント・シークレット」を書き留めます。

    Oracle Content Managementアプリケーションの名前は、通常、CECSXXX_<instance name>と似ています。

  2. 「構成」タブの「リソース」パネルを展開し、必要なスコープのURL(通常はOracle Content Managementインスタンスの/documents"エンドポイントに対応するスコープ)を書き留めます。 URLはhttps://<primary audience url>/documentsと似ています。

    他のOracle Content Management機能(ソーシャルなど)が必要な場合は、対応するスコープのURLをノートする必要があります。

サービス接続の作成時に、サービス接続に次のいずれかの認証メソッドを使用できます:

認証方式 詳細
基本

このオプションを使用するには、次の詳細を指定する必要があります:

  • ユーザー名パスワード: IDCSからの任意のユーザーの有効な資格証明。
OAuth 2.0 Resource Ownerのパスワード

このオプションを使用するには、次の詳細を指定する必要があります:

  • クライアントID機密: IDCSでOracle Content Managementアプリケーションから取得します。
  • ユーザー名パスワード: Oracle Content Management RESTエンドポイントへのアクセス権を持つユーザーの有効な資格証明。
  • トークンURL: IDCSからアクセス・トークンを取得するために使用されるエンドポイントのURL (<base_URL_corresponding_to_Oracle_Content_Management_in_IDCS>/oauth2/v1/token形式)。
  • スコープ IDCSでOracle Content Managementアプリケーションから取得します。

IDCSへのアクセス権がない場合は、管理者からOracle Content Managementアプリケーションの詳細を取得します。

固定資格証明を使用してOracle Content Managementに接続するには:

  1. ナビゲータでサービスを開き、+記号をクリックして「サービス接続」を選択します。
  2. サービス接続の作成ウィザードのソースの選択ステップで「エンドポイントで定義」をクリックします。
  3. HTTPメソッドを選択し、Oracle Content ManagementエンドポイントのURLを入力します。
    たとえば、エンドポイントのURLは次のようになります : https://<Oracle_Content_Management_instance>/documents/api/<VERSION>/folders/{folderId}
  4. 「サーバー」タブの「認証」セクションで、認証メソッドとして「OAuth 2.0リソース所有者資格証明」を選択します。
  5. クライアントID、クライアント・シークレット、スコープおよびトークンURLの詳細を入力します。
    クライアントID、クライアント・シークレットおよびスコープの詳細は、IDCSでOracle Content Managementアプリケーションに書き留めたものです。
  6. サービス接続をテストします。
  7. オプショナル: サービス接続をアプリケーションの匿名ユーザーがアクセスできるようにする場合は、サーバー・タブから起動する「サーバーの編集」ダイアログでサービス接続インフラストラクチャへの匿名アクセスを許可チェック・ボックスを選択します。 「匿名ユーザーの認証」ドロップダウン・リストを使用して、匿名ユーザーの認証タイプを構成します。