クイック・スタート

前提条件を完了し、curlをインストールし、ユーザー、グループ、アプリケーションなどのアイデンティティ・ドメイン・リソースを管理するための認可を設定することで、アイデンティティ・ドメインREST APIをすぐに開始します。

前提条件

Oracle Cloudサブスクリプションの購入: Oracle Cloudサブスクリプションを購入を参照してください。
オーダーのアクティブ化: アカウントの設定またはオーダーのアクティブ化。Oracle Cloudサブスクリプションの購入のようこそ電子メールでの注文のアクティブ化を参照してください。
アイデンティティ・ドメイン管理者からアイデンティティ・ドメインAPIにアクセスするための適切なアカウント資格証明および認可を取得します:
- アイデンティティ・ドメインにサインインします。ユーザー名、パスワードおよびアイデンティティ・ドメイン名を取得するには、アイデンティティ・ドメイン管理者に連絡してください。
- ユーザー・アカウントなしでAPIを使用する。管理者は、アイデンティティ・ドメイン内のユーザー・アカウントなしでアイデンティティ・ドメインAPIを使用できます。ユーザー・アカウントなしでアイデンティティ・ドメインAPIを使用するには、アイデンティティ・ドメイン管理者からクライアントIDおよびクライアント・シークレットをリクエストします。

アカウントをアクティブ化した後、サインイン資格証明、およびアイデンティティ・ドメインのホームページへのリンクが送信されます。電子メールのリンクをクリックし、提供されたサインイン資格証明を入力します。アイデンティティ・ドメインのホームページが表示されます。コンソールへのサインインを参照してください。

このドキュメント内の例では、cURLコマンドライン・ツールを使用して、アイデンティティ・ドメインREST APIにアクセスする方法を示します。

サーバーに安全に接続するには、SSLをサポートしているバージョンのcURLをインストールし、Verisign CA証明書に対して認証されるSSL認証局(CA)証明書ファイルまたはバンドルを指定する必要があります。詳細は次を参照してください。

次の例では、Windows 64-bitシステムでのcURLのインストール方法を示します。

ブラウザで、cURLのホームページ(http://curl.haxx.se/download.html)にナビゲートします。
「cURL Releases and Downloads」ページで、使用しているOSに対応するSSL対応バージョンを見つけ、ZIPファイルをダウンロードするリンクをクリックします。
ソフトウェアをインストールします。
「cURL CA Certs」ページ(http://curl.haxx.se/docs/caextract.html)にナビゲートし、cURLをインストールしたフォルダにCA-bundle.crt SSL認証局(CA)証明書バンドルをダウンロードします。
cURL環境変数を設定します。
1. コマンド・ウィンドウを開きます。
2. cURLをインストールしたディレクトリに移動します。
3. cURL環境変数(CURL_CA_BUNDLE)にSSLCA証明書バンドルの位置を設定します。たとえば: C:\curl> set CURL_CA_BUNDLE=ca-bundle.crt。

アイデンティティ・ドメインREST APIには、RESTエンドポイントを含むURL、アクセスするリソース、およびリクエストに含める問合せパラメータを使用してアクセスします。

アイデンティティ・ドメインREST APIの基本的なエンドポイントは次のとおりです。

https://<domainURL>/admin/v1/

これらのURLの作成の詳細は、リクエストの送信を参照してください。

リクエストをアイデンティティ・ドメインREST APIに送信することを認可するために使用できるアクセス・トークンを生成する必要があります。「APIを使用した認可の管理」を参照してください。

これで、cURLを使用してアイデンティティ・ドメインにリクエストを送信する準備ができました。

REST APIを使用して、アイデンティティ・ドメイン全体の構成とアイデンティティおよびリソースの管理を開始します。