UIによるサービス間認証の作成

以下のステップを実行します。

1. IBM Cloudアカウントにログインする.

2. IBM Cloud コンソールで、「管理」 > **「アクセス (IAM)」をクリックし、「許可」**を選択します。

3. 「作成」 をクリックします。

4. ソースアカウントを設定する。 このアカウントを選択します。

5. ソース・サービスとしてログ・ルーティングを選択します。 そして、アクセスのスコープをすべてのリソースに設定する。

6. 対象サービスとしてクラウドログを選択します。 すべてのリソースに設定すると、すべてのIBM Cloud Logsインスタンス、または選択した属性に基づくリソース > サービスインスタンスに設定することで単一のインスタンスへのアクセスが許可されます。

   その他の属性は、このタイプの認可ではサポートされていない。

7. Service Accessセクションで、Sender を選択して、ターゲット・サービスにアクセスするソース・サービスへのアクセスを割り当てます。

8. 「許可」 をクリックします。

CLIを使用したサービス間認証の作成

IBM Cloud Logs と IBM® Cloud Logs Routingは、IBM® Cloud Logs Routingサービスがテナントにログを送信できるようにします。

以下のステップを実行します。

1. IAMベアラートークンを取得し、環境変数としてエクスポートする。 以下のコマンドを実行します。

   IBM Cloud® Identity and Access Management (IAM) アクセストークンを取得して、IBM® Cloud Logs Routing サービスへのリクエストを認証する必要があります。 詳細については、アクセス・トークンのリトリーブを参照してください。

   例えば、以下のCLIコマンドを実行することで、IAMベアラートークンを取得し、環境変数としてエクスポートすることができます：

   export IAM_TOKEN=`ibmcloud iam oauth-tokens --output json | jq -r '.iam_token'`
   

   トークンが正しくエクスポートされたことをターミナルに表示して確認してください。

   echo $IAM_TOKEN
   

   出力は Bearer で始まり、文字、数字、記号を含む文字列が続くはずである。

2. 認可ポリシーを作成する。

   ibmcloud iam authorization-policy-create logs-router logs Sender
   

詳細は S2S権限を作成し、IBM Cloud Logsにログを送信するためのアクセスを許可する を参照。

APIを使用したテナントとターゲットの作成

コマンドラインから以下の cURL ：

createリクエストは、リージョンとデスティネーションにテナントを作成する。

curl -X POST https://<MANAGEMENT-API-ENDPOINT>:443/v1/tenants \
-H "Content-Type: application/json" \
-H "Authorization: ${IAM_TOKEN}" \
-H 'IBM-API-Version: DATE' \
--data '{
    "name": "TENANT_NAME",
    "targets": [
        {
            "log_sink_crn": "CLOUD_LOGS_INSTANCE_ID",
            "name": "TARGET_NAME",
            "parameters": {
                "host": "CLOUD_LOGS_INSTANCE_INGRESS_ENDPOINT",
                "port": PORT
            }
        }
    ]
}'

説明

コマンドには、以前に収集した値が含まれているので、注意深く見直してください。 コマンドが期待通りに動作するように、必要な置換を行ってください。

作成リクエストに成功すると、テナントのメタデータを含むレスポンスが返されます。 以下に例を示します。

{
    "id": "3517d2ed-9429-af34-ad52-34278391cbc8:",
    "created_at": "2023-10-20T18:30:00.143156Z",
    "updated_at": "2023-10-20T18:30:00.143156Z",
    "crn": "crn:v1:bluemix:public:logs-router:eu-de:a/3516b8fa0a174a71899f5affa4f18d78:3517d2ed-9429-af34-ad52-34278391cbc8::",
    "name": "tenant",
    "etag": "\"822b4b5423e225206c1d75666595714a11925cd0f82b229839864443d6c3c049\"",
    "targets": [
    {
        "id": "86432b-66a6-df12-7003-888a21a2b3",
        "log_sink_crn": "crn:v1:bluemix:public:logs:eu-gb:a/91d1d1e42f9b684df920bbd06461c222:743e3b4f-72bc-4669-9fa6-0e6621d0b232::",
        "name": "my-log-sink",
        "etag": "\"c3a43545a7f2675970671ac3a57b8db067a1866b2222e1b950ee8da612e347c6\"",
        "type": "logs",
        "created_at": "2023-10-20T18:30:00.143156Z",
        "updated_at": "2023-10-20T18:30:00.143156Z",
        "parameters": {
            "host": "743e3b4f-72bc-4669-9fa6-0e6621d0b232.ingress.eu-gb.logs.cloud.ibm.com",
            "port": 443
        }
    }
    ]
}

UIを使用したテナントの作成

以下のステップを実行します。

1. IBM Cloudアカウントにログインする.

2. 「メニュー」 アイコン>「可観測性」 をクリックする。

3. ロギング > ルーティングをクリックします。

4. 目標設定をクリックします。

5. リストから IBM Cloud Logs インスタンスを選択する。 これは、 IBM Cloud Logs Routing によってルーティングされたログを受信したいインスタンスです。

   リストから IBM Cloud Logs インスタンスを選択するか、特定のCRNを指定することができます。

   IBM Cloud Logsインスタンスは、構成しているのと同じアカウントになければなりません。

6. 保存 をクリックします。