1. <ProductName> REST API Oracle Identity Governance Self ServiceのREST API
  2. cURLの使用

cURLの使用

このドキュメント内の例では、cURLを使用してOIG Self ServiceのREST APIにアクセスする方法を説明しています。

タスク1: cURLのインストール

このドキュメント内の例ではcURLコマンドライン・ツールを使用してOIG Self ServiceのREST APIへのアクセス方法を示します。

サーバーに安全に接続するには、Verisign CA証明書に対して信頼できることを証明するSSL認証局(CA)の証明書ファイルまたはバンドルを備えたSSL対応バージョンのcURLをインストールする必要があります。認証の詳細は、「認証」を参照してください。

次の手順では、Windows 64ビット・システムでのcURLのインストール方法を示します。

  1. ブラウザで、cURLホーム・ページ(http://curl.haxx.se)に移動し、左のナビゲーション・メニューで「Download」をクリックします。

  2. 「cURL Releases and Downloads」ページで、使用しているオペレーティング・システムに対応したcURLソフトウェアのSSL対応バージョンを見つけ、ZIPファイルをダウンロードするリンクをクリックしてソフトウェアをインストールします。

  3. 「cURL CA Certs」ページ(http://curl.haxx.se/docs/caextract.html)にナビゲートし、cURLをインストールしたフォルダにca-bundle.crt SSL CA証明書バンドルをダウンロードします。

タスク2: cURLの環境変数の設定

コマンド・ウィンドウで、cURL環境変数CURL_CA_BUNDLEを、ローカルCA証明書バンドルの場所に設定します。たとえば:

C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt

これで、cURLを使用してOIGにリクエストを送信する準備ができました。

タスク3: cURLの呼出し

cURLを呼び出し、次の表に定義したコマンド行オプションを必要に応じて1つ以上指定してその実行を指示します。

cURLオプション 説明
-d, --data @file.json ローカル・マシン上のJSON形式のリクエスト本文を含むファイルを指定します。
-H リクエスト・ドキュメントのコンテンツ・タイプを定義します。
-i レスポンス・ヘッダー情報を表示します。
-X リクエストの種類を指定します(GET、POSTなど)。
-k cURLでセキュアでないSSL接続および転送の実行を許可します。すべてのSSL接続は、デフォルトでインストールされるCA証明書バンドルを使用して、セキュアになるように試行されます。このため、-k/--insecureを使用しないと、すべてのセキュアでない接続は失敗します。

たとえば:

curl -i -X GET -u <username>:<password> -H <request-header>:<value> https://<subdomain>.<domain>.com/<path>/<resource-path>

cURLの詳細は、次のURLを参照してください。

https://curl.haxx.se/docs/manpage.html