CIS CLI リファレンス

IBM Cloud® Internet Services には、コマンド・ライン・インターフェース (CLI) から使用できるいくつかのコマンド・ファミリーが用意されています。 各セット内(例 Create: Delete、、 Update、)で、 IBM Cloud Internet Services ( CIS )のコマンド一式を見つけてください。

開始前に

  1. IBM CLI をダウンロードします。

  2. IBM Cloud にログインします。

    ibmcloud login -a
    
  3. CIS CLI プラグインをインストールします。

    ibmcloud plugin install cis
    
  4. コンテキスト・インスタンスを設定します。

    ibmcloud cis instance-set <instance-name>
    

プラグインのリストとインストールされているバージョンを確認するには、このコマンドを実行します。

ibmcloud plugin list

CLI の利用可能な更新あるかどうかが、リストで返されます。 次のコマンドを実行して、CIS CLI プラグインを更新します。

ibmcloud plugin update cis

IBM Cloud CLI のインストールおよび設定については、 IBM Cloud CLI の入門を 参照してください。

アクセス・アプリケーション

ibmcloud cis access-app-create

Enterprise Plans Only

DNSドメイン用のアクセスアプリケーションを作成します。

ibmcloud cis access-app-create DNS_DOMAIN_ID --name NAME --domain DOMAIN [--session-duration SESSION_DURATION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のアクセス・アプリケーションを作成します。

ibmcloud cis access-app-create DNS_DOMAIN_ID --name exampleCreate --domain example.com --session-duration 12h

ibmcloud cis access-apps

Enterprise Plans Only

DNS ドメインのすべてのアクセスアプリケーションを一覧表示します。

ibmcloud cis access-apps DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のすべてのアクセス・アプリケーションをリストします。

ibmcloud cis access-apps DNS_DOMAIN_ID

ibmcloud cis access-app

Enterprise Plans Only

アクセス・アプリケーションの詳細を表示します

ibmcloud cis access-app DNS_DOMAIN_ID ACCESS_APPLICATION_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
ACCESS_APPLICATION_ID
アクセス・アプリケーションのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

アクセス・アプリケーション a5836c2a7ea72d2e225890caea70ae32 の詳細を表示します。

ibmcloud cis access-app DNS_DOMAIN_ID ACCESS_APPLICATION_ID

ibmcloud cis access-app-update

Enterprise Plans Only

アクセス・アプリケーションを更新します。

ibmcloud cis access-app-update DNS_DOMAIN_ID ACCESS_APPLICATION_ID --name NAME --domain DOMAIN [--session-duration SESSION_DURATION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
ACCESS_APPLICATION_ID
アクセス・アプリケーションのID。 必須。
--name
アプリケーション名。 必須。
--domain
Accessがブロックするドメインとパス。 必須。
--session-duration
このアプリケーションに対して発行されたトークンの有効期間を定義します。 有効な値は、30m、6h、12h、24h、168h、および730hです。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

アクセス・アプリケーション a5836c2a7ea72d2e225890caea70ae32 を更新します。

ibmcloud cis access-app-update DNS_DOMAIN_ID ACCESS_APPLICATION_ID --name exampleUpdate --domain example.com --session-duration 24h

ibmcloud cis access-app-delete

Enterprise Plans Only

アクセス・アプリケーションを削除します。

ibmcloud cis access-app-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
ACCESS_APPLICATION_ID
アクセス・アプリケーションのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

アクセス・アプリケーション a5836c2a7ea72d2e225890caea70ae32 を削除します。

ibmcloud cis access-app-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID

アクセス証明書

ibmcloud cis access-certificate-create

Enterprise Plans Only

DNS ドメイン用のアクセス証明書を作成します。

ibmcloud cis access-certificate-create DNS_DOMAIN_ID --name NAME --ca-cert-file CERT_FILE [--associated-hostnames ASSOCIATED_HOSTNAMES] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--name
証明書の名前。 必須。
--ca-cert-file
証明書のルート CA ファイル。 必須。
--associated-hostnames
この証明書に対して入力が求められるホスト名。
ACCESS_APPLICATION_ID
アクセス・アプリケーションのID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のアクセス証明書を作成します。

ibmcloud cis access-certificate-create DNS_DOMAIN_ID --name example --ca-cert-file CERT_FILE --associated-hostnames example.com

ibmcloud cis access-certificates

Enterprise Plans Only

DNS ドメインのすべてのアクセス証明書を一覧表示します。

ibmcloud cis access-certificates DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のすべてのアクセス証明書をリストします。

ibmcloud cis access-certificates DNS_DOMAIN_ID

ibmcloud cis access-certificate

Enterprise Plans Only

アクセス証明書の詳細を表示します

ibmcloud cis access-certificate DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
ACCESS_CERTIFICATE_ID
アクセス証明書のID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

アクセス証明書 a5836c2a7ea72d2e225890caea70ae32 の詳細を表示します。

ibmcloud cis access-certificate DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

ibmcloud cis access-certificate-update

Enterprise Plans Only

アクセス証明書を更新します。

ibmcloud cis access-certificate-update DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID --name NAME --associated-hostnames ASSOCIATED_HOSTNAMES [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

ACCESS_CERTIFICATE_ID

アクセス証明書のID。 必須。

--name

証明書の名前。 必須。

--associated-hostnames

この証明書に対して入力が求められるホスト名。 必須。

関連するホスト名は、associated-hostnames で指定されない場合、リセットされます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

アクセス証明書を更新してください a5836c2a7ea72d2e225890caea70ae32。

ibmcloud cis access-certificate-update DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID --name example --associated-hostnames example.com

ibmcloud cis access-certificate-delete

Enterprise Plans Only

アクセス証明書を削除します。

ibmcloud cis access-certificate-delete DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID [-i, --instance INSTANCE]

証明書を削除する前に、関連するホスト名をクリアする必要があります。

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
ACCESS_CERTIFICATE_ID
アクセス証明書のID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

アクセス証明書を削除してください a5836c2a7ea72d2e225890caea70ae32。

ibmcloud cis access-certificate-delete DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

ibmcloud cis access-certificates-settings

Enterprise Plans Only

DNS ドメインのアクセス証明書設定を取得します。

ibmcloud cis access-certificates-settings DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のアクセス証明書設定を取得します。

ibmcloud cis access-certificates-settings DNS_DOMAIN_ID

ibmcloud cis access-certificates-settings-update

Enterprise Plans Only

DNS ドメインのアクセス証明書設定を更新します。

ibmcloud cis access-certificates-settings-update DNS_DOMAIN_ID (-f, --feature FEATURE) (-v, --value VALUE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-f, --feature
証明書設定の機能。 有効値:
client_certificate_forwarding
クライアント証明書のペイロードとその SHA256 署名は、 および CF-Client-Cert-DER_BASE64 CF-Client-Cert-SHA256 ヘッダーを通じてオリジンサーバーに転送されます。
-v, --value
証明書の機能に設定される値。
client_certificate_forwarding
クライアント証明書を転送するかどうかを指定するために、ホスト名を指定してください。 例えば、-v host1=on,host2=on,host3=off です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のアクセス証明書設定を更新します。

ibmcloud cis access-certificates-settings-update DNS_DOMAIN_ID -f client_certificate_forwarding -v mtls1.example.com=on,mtls2.example.com=off

アクセス・ポリシー

ibmcloud cis access-policy-create

Enterprise Plans Only

アクセスアプリケーションのアクセスポリシーを作成します。

ibmcloud cis access-policy-create DNS_DOMAIN_ID ACCESS_APPLICATION_ID --name NAME --decision DECISION --include INCLUDE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
ACCESS_APPLICATION_ID
アクセス・アプリケーションのID。 必須。
--name
ポリシーの名前。 必須。
--decision
ポリシーがユーザーに一致した場合に、Accessが実行するアクションを定義します。 有効な値は です non_identity。 必須。
--include
ポリシーのインクルード・ルール。 有効な値は certificate および common_name です。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

アクセス アプリケーション用のアクセスポリシーを作成します a5836c2a7ea72d2e225890caea70ae32。

ibmcloud cis access-policy-create DNS_DOMAIN_ID ACCESS_APPLICATION_ID --name examplePolicy --decision non_identity --include certificate --include common_name=test

ibmcloud cis access-policies

Enterprise Plans Only

アクセス・アプリケーションのすべてのアクセスポリシーを一覧表示します。

ibmcloud cis access-policies DNS_DOMAIN_ID ACCESS_APPLICATION_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
ACCESS_APPLICATION_ID
アクセス・アプリケーションのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

アクセス・アプリケーション a5836c2a7ea72d2e225890caea70ae32 のすべてのアクセス・ポリシーをリストします。

ibmcloud cis access-policies DNS_DOMAIN_ID ACCESS_APPLICATION_ID

ibmcloud cis access-policy

Enterprise Plans Only

アクセス・ポリシーの詳細を表示します

ibmcloud cis access-policy DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
ACCESS_APPLICATION_ID
アクセス・アプリケーションのID。 必須。
ACCESS_POLICY_ID
アクセスポリシーのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

アクセス・ポリシー a5836c2a7ea72d2e225890caea70ae32 の詳細を表示します。

ibmcloud cis access-policy DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

ibmcloud cis access-policy-delete

Enterprise Plans Only

アクセス・ポリシーを削除します。

ibmcloud cis access-policy-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
ACCESS_APPLICATION_ID
アクセス・アプリケーションのID。 必須。
ACCESS_POLICY_ID
アクセスポリシーのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

アクセス・ポリシー 65fe21071877669cc69544642bc6c4c4 を削除します。

ibmcloud cis access-policy-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

キャッシュ

以下のコマンド cache を使用して、キャッシュの動作を調整します:

ibmcloud cis cache-purge

DNS ドメインに対して、キャッシュされたアセットをファイル単位または一括でクリアし、配信されるアセットが確実に最新の状態になるようにします。

ibmcloud cis cache-purge DNS_DOMAIN_ID (--all | --file file1 --file file2...|--tag tag1 --tag tag2...|--host host1 --host host...| --prefix prefix1 --prefix prefix2...) [-f, --force] [-i, --instance INSTANCE_NAME]  [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--all
すべてのキャッシュ・ファイルをパージ中です。 このオプションは --file と同時に指定することはできません。
--file
URL を指定することにより、1 つ以上のファイルを個別に削除します。 このオプションは --all と同時に指定することはできません。
--tag
関連付けられた Cache-Tag により、1 つ以上のファイルを個別に削除します。 このオプションは、 --all オプションと併用できません。 Enterprise Plans Only
--host
ホストを指定することにより、1 つ以上のファイルを個別に削除します。 このオプションは、 --all オプションと併用できません。 Enterprise Plans Only
--prefix
プレフィックスにより、1 つ以上のファイルを個別に削除します。 このオプションは、 --all オプションと併用できません。 Enterprise Plans Only
-f, --force
確認のプロンプトを出さずにすべてのキャッシュ・ファイルをパージ中です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のキャッシュに入れられたアセット・ファイルをすべてクリアします。

ibmcloud cis cache-purge DNS_DOMAIN_ID --all --force

ibmcloud cis cache-settings

DNS ドメインのキャッシュ設定を取得します。

ibmcloud cis cache-settings DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のキャッシュ設定を取得します。

ibmcloud cis cache-settings DNS_DOMAIN_ID

ibmcloud cis cache-settings-update

指定された DNS ドメインのキャッシュ設定を更新します。

ibmcloud cis cache-settings-update DNS_DOMAIN_ID [--caching-level LEVEL][--browser-expiration EXPIRATION] [--development-mode (on | off)] [--serve-stale-content (on | off)] [--query-string-sort (on | off)] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--caching-level

キャッシュされたアセットをユーザーに配信する URL の条件を指定してください。 有効な値は no-query-string、 query-string-independent、 query-string-dependent。

  • no-query-string: クエリ文字列が存在しない場合にのみ、キャッシュからリソースを配信する。
  • query-string-independent: クエリ文字列に関係なく、すべてのユーザーに同じリソースを提供します。
  • query-string-dependent: クエリ文字列が変更されるたびに、異なるリソースを返します。
--browser-expiration

ブラウザがキャッシュされたアセットを保存する期間を指定してください。

  • 有効な値は respect-existing-header、 30s, 1M, 5M,, 20M, 30M, 1h, 2h, 4h, 8h, 16h, 1d``3d,, 8d``16d, 1m, 6m, および です 1y。
  • 30s, 1M, 5M, および は、Enterprise プランまたは Security プランのインスタンスでのみ利用可能です 20M。
  • 30s は、...を意味します 30 seconds。
  • 30M は、...を意味します 30 minutes。
  • 1h は、...を意味します 1 hour。
  • 1d は、...を意味します 1 day。
  • 1m は、...を意味します 1 month。
  • 1y は、...を意味します 1 year。
--development-mod

すべてのエッジ・キャッシュをバイパスして、トラフィックを起点サーバーに向けて送信します。

--serve-stale-content

オリジンサーバーがオフラインの場合でも、コンテンツの有効期限が切れていても、ユーザーにはキャッシュされたコンテンツを引き続き提供します。

--query-string-sort: キャッシュ内では、 CIS は、クエリ文字列の順序にかかわらず、同じクエリ文字列を持つファイルを同一のファイルとして扱います。

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のキャッシュ設定を更新します。

ibmcloud cis cache-settings-update DNS_DOMAIN_ID --caching-level no-query-string --browser-expiration 1h

カスタムリスト

以下のコマンド custom-lists を使用して、カスタムリストの動作を調整します:

ibmcloud cis custom-lists lists

インスタンスのカスタムリストをリストします。

ibmcloud cis custom-lists lists [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis custom-lists lists

ibmcloud cis custom-lists list

インスタンスのカスタムリストを取得する。

ibmcloud cis custom-lists list LIST_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

LIST_ID
カスタムリストのID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis custom-lists list LIST_ID --output json

ibmcloud cis custom-lists list-create

インスタンスのカスタムリストを作成する。

ibmcloud cis custom-lists list-create (--kind KIND) (--name NAME) [--description DESCRIPTION] [-i, --instance INSTANCE]

JSON入力(ファイルから、または文字列として直接)も受け付けることができる:

ibmcloud cis custom-lists list-create (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE]

コマンド・オプション

--kind

カスタムリストの種類。 有効な値は ip、 asn、 hostname。

--name

リスト名。

--description

リストの説明

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--json

カスタムリストを記述するために使用される JSON ファイルまたは JSON 文字列。

JSON データにおける必須フィールドは以下の通りです:

kind カスタムリストの種類。 有効な値は ip、 asn、 hostname である。

name リスト名。

オプションのフィールドは

"description": リストの説明。

サンプル JSON データ:

{
  "kind": "ip",
  "name": "string",
  "description": "string"
}

例

ibmcloud cis custom-lists list-create --kind ip --name iplistone --instance INSTANCE
ibmcloud cis custom-lists list-create --json @example.json --instance INSTANCE

ibmcloud cis custom-lists list-update

カスタムリストの説明を更新する。

ibmcloud cis custom-lists list-update LIST_ID (--description DESCRIPTION) [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis custom-lists list-update LIST_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

LIST_ID

カスタムリストのID。

--description

リストを簡単に説明する。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

json

カスタムリストを記述するために使用される JSON ファイルまたは JSON 文字列。

オプションのフィールドは

"description": リストの概要を簡潔に説明する。

サンプル JSON データ:

  {
    "description": "string"
  }

例

ibmcloud cis custom-lists list-update LIST_ID --description "description example"
ibmcloud cis custom-lists list-update LIST_ID --json @example.json

ibmcloud cis custom-lists list-delete

インスタンスのカスタムリストを削除します。

ibmcloud cis custom-lists list-delete LIST_ID [-f, --force] [-i, --instance INSTANCE]

コマンド・オプション

LIST_ID
カスタムリストのID。
-f, --force
確認のメッセージを表示せずにカスタムリストを削除しようとしました。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ibmcloud cis custom-lists list-delete LIST_ID

ibmcloud cis custom-lists items

ibmcloud cis custom-lists items LIST_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

LIST_ID
カスタムリストのID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis custom-lists items LIST_ID

ibmcloud cis custom-lists item

カスタムリストの特定の項目を表示します。

ibmcloud cis custom-lists item LIST_ID ITEM_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

LIST_ID
カスタムリストのID。
ITEM_ID
カスタムリスト項目のID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis custom-lists item LIST_ID ITEM_ID

ibmcloud cis custom-lists item-create

カスタムリストに新しい項目を作成する。

ibmcloud cis custom-lists item-create LIST_ID (--asn ASN | --ip IP | --hostname HOSTNAME) [--comment COMMENT] [-i, --instance INSTANCE]
ibmcloud cis custom-lists item-create LIST_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE]

コマンド・オプション

LIST_ID

カスタムリストのID。

--asn

ASNの値。

--ip

IPv4 アドレス。

--hostname

ホスト名。

--comment

この件に関する簡単なコメントを述べること。

-i, --instance

インスタンスの名前または ID。 instanceまたはIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--json

カスタムリストを記述するために使用される JSON ファイルまたは JSON 文字列。

JSON データにおける必須フィールドは以下の通りです:

items 作成するカスタムリスト項目のリスト。

asn ASN.

hostname: ホスト名。

ip IPv4 アドレス。

comment この件に関する簡単なコメントを述べること。

サンプル JSON データ:

  [
    {
      "asn": 19604,
      "comment": "My list of developer IPs.",
      "hostname": "cloud.ibm.com",
      "ip": "172.64.0.0/13"
    }
  ]

コマンドの例

ibmcloud cis custom-lists item-create LIST_ID --ip 192.0.0.3
ibmcloud cis custom-lists item-create LIST_ID --json @example.json

ibmcloud cis custom-lists item-update

カスタムリストのすべてのリスト項目を更新します。

ibmcloud cis custom-lists item-update LIST_ID (--json @JSON_FILE | JSON_STRING) [-f, --force] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

LIST_ID

カスタムリストのID。

--json

カスタムリストを記述するために使用される JSON ファイルまたは JSON 文字列。

JSON データにおける必須フィールドは以下の通りです:

items 作成するカスタムリスト項目のリスト。

asn ASN の値。

hostname: ホスト名。

ip IPv4 アドレス。

comment この件に関する簡単なコメントを述べること。

サンプル JSON データ:

   [
     {
       "asn": 19604,
       "comment": "My list of developer IPs.",
       "hostname": "cloud.ibm.com",
       "ip": "172.64.0.0/13"
     }
   ]
-f, --force

確認のメッセージを表示せずにカスタムリストを削除しようとしました。

--output value

出力形式。 現在、 が唯一サポートされている値です json。

-i, --instance

インスタンスの名前または ID。 インスタンス値またはIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ibmcloud cis custom-lists item-update LIST_ID --json @example.json -f

ibmcloud cis custom-lists item-delete

カスタムリストから項目を削除します。

ibmcloud cis custom-lists item-delete LIST_ID (--item-id CUSTOM_LIST_ITEM_ID) [-f, --force] [-i, --instance INSTANCE]
ibmcloud cis custom-lists item-delete LIST_ID (--json @JSON_FILE | JSON_STRING) [-f, --force] [-i, --instance INSTANCE]

コマンド・オプション

LIST_ID

カスタムリストのID。

--item-id

CUSTOM_LIST_ITEM_ID はカスタムリスト項目のIDです。

-f, --force

確認のメッセージを表示せずにカスタムリストを削除しようとしました。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--json

カスタムリストを記述するために使用される JSON ファイルまたは JSON 文字列。

JSON データにおける必須フィールドは以下の通りです:

items 削除するカスタムリスト項目のIDによるリスト。

id カスタムリスト項目のユニークID。

サンプル JSON データ:

  {
    "items": [
      {
        "id": "70c2009751b24ffc9ed1ab462ba957b4"
      }
    ]
  }

例

ibmcloud cis custom-lists item-delete LIST_ID --item-id CUSTOM_LIST_ITEM_ID --force
ibmcloud cis custom-lists item-delete LIST_ID --json @example.json --force

ibmcloud cis custom-lists operation

カスタムリスト操作のステータスを取得します。

ibmcloud cis custom-lists operation OPERATION_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

OPERATION_ID
カスタムリスト操作のID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis custom-lists operation OPERATION_ID --output json

カスタム・ページ

以下のコマンド custom-page を使用して、カスタムページの動作を調整します:

ibmcloud cis custom-page-update

特定のカスタム・ページを更新します。

ibmcloud cis custom-page-update PAGE_ID PAGE_URL [-d, --domain DNS_DOMAIN_ID] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

PAGE_ID
カスタム・ページ・タイプの名前。 有効な値は basic_challenge、 country_challenge、 ip_block、、 ratelimit_block、 serve_stale_content、 under_attack、 waf_block、 waf_challenge、 1000_errors、 です 500_errors。必須項目です。
PAGE_URL
カスタム・ページに関連付けられている URL。 例えば、http://www.example.com/example.html です。 値 default はデフォルト・ページを使用することを意味します。 必須。
-d, --domain
DNS ドメイン ID。
-i,- --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン basic_challenge の 31984fea73a15b45779fa0df4ef62f9b ページを更新します。

ibmcloud cis custom-page-update basic_challenge http://www.example.com/example.html -d DNS_DOMAIN_ID

ibmcloud cis custom-page

特定のカスタム・ページを取得します。

ibmcloud cis custom-page PAGE_ID [-d, --domain DNS_DOMAIN_ID] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

PAGE_ID
カスタム・ページ・タイプの名前。 有効な値は basic_challenge、 country_challenge、 ip_block、、 ratelimit_block、 serve_stale_content、 under_attack、 waf_block、 waf_challenge、 1000_errors、 および です 500_errors。 必須。
-d, --domain
DNS ドメイン ID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン basic_challenge の 31984fea73a15b45779fa0df4ef62f9b ページを取得します。

ibmcloud cis custom-page basic_challenge -d DNS_DOMAIN_ID

ibmcloud cis custom-pages

現在存在しているカスタム・ページのリストを取得します。

ibmcloud cis custom-pages [-d, --domain DNS_DOMAIN_ID] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

-d, --domain
DNS ドメイン ID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

DNS_DOMAIN_ID ドメインの既存のカスタムページをリストアップする。

ibmcloud cis custom-pages -d DNS_DOMAIN_ID

DNS レコード

以下のコマンド dns-record を使用して、DNSレコードの動作を調整します:

ibmcloud cis dns-record-create

サービスインスタンスのドメインに対して DNS レコードを作成します。

ibmcloud cis dns-record-create DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis dns-record-create DNS_DOMAIN_ID --type TYPE --name NAME --content CONTENT [--ttl TTL] [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis dns-record-create DNS_DOMAIN_ID --json-str JSON_STR [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis dns-record-create DNS_DOMAIN_ID --json-file JSON_FILE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--name

DNS レコード名。

--type

DNS レコード・タイプ。

--content

DNS レコード・コンテンツ。

--ttl

DNS レコードの存続時間。 値1は automatic. デフォルト値は1です。

--proxied

トラフィックが CIS 上のセキュリティー機能とパフォーマンス機能を通過するかどうかを制御します。 CIS は A、 AAAA、およびレコード CNAME のトラフィックのみをプロキシします。 有効な値は true と false です。

--json

DNSレコードを記述するために使用されるJSONファイルまたはJSON文字列。 サポートされる DNS レコード・タイプは A、AAAA、CNAME、NS、TXT、MX、LOC、SRV、CAA、PTR です。

  • タイプ A, AAAA, CNAME, NS, については: TXT
    • JSON データ内の必須フィールドは、name、type、content です。
    • オプションのフィールドは ttl、 : proxied
      • proxied トラフィックが CIS 上のセキュリティー機能とパフォーマンス機能を通過するかどうかを制御します。 CIS は、 A,``AAAA およびレコード CNAME のトラフィックのみをプロキシします。

サンプル JSON データ:

{
   "name": "testA",
   "type": "A",
   "content": "127.0.0.1",
   "proxied": true
}
{
   "name": "testAAAA",
   "type": "AAAA",
   "content": "2001:0db8:0012:0001:3c5e:7354:0000:5db1",
   "proxied": false
}
{
   "name": "testCNAME",
   "type": "CNAME",
   "content": "example.com"
}
{
   "name": "testNS",
   "type": "NS",
   "content": "ns1.example.com"
}
{
   "name": "testTXT",
   "type":"TXT",
   "content": "text information"
}
  • 対象: PTR
    • JSON データ内の必須フィールドは、name、type、content です。
    • オプション・フィールドは ttl です。

サンプル JSON データ:

{
 "name": "1.2.3.4",
 "type":"PTR",
 "content": "abc.test.com"
}
  • 対象: MX
    • JSON データ内の必須フィールドは、name、type、content です。
    • オプションのフィールドは ttl および です priority。

サンプル JSON データ:

{
   "name": "testMX",
   "type": "MX",
   "content": "smtp.example.com",
   "priority": 10
}
  • 対象: LOC
    • JSON データ内の必須フィールドは、name、type、data です。
      • data:
        • lat_degrees: 緯度の度数。
        • lat_minutes: 許容誤差
        • lat_seconds: 緯度の秒。
        • lat_direction: 緯度・経度。
        • long_degrees: 経度。
        • long_minutes: 経度の分。
        • long_seconds: 経度の秒。
        • long_direction: 経度の方向。
        • altitude: 設置場所の標高(メートル単位)。
        • size: 場所の広さをメートル単位で表記。
        • precision_horz: 位置情報の水平方向の精度。
        • precision_vert: 位置の垂直方向の精度。
      • オプション・フィールドは ttl です。

サンプル JSON データ:

{
   "name": "testLOC",
   "type": "LOC",
   "data": {
         "lat_degrees": 45,
         "lat_minutes": 0,
         "lat_seconds": 0,
         "lat_direction": "N",
         "long_degrees": 45,
         "long_minutes": 0,
         "long_seconds": 0,
         "long_direction": "E",
         "altitude": 20,
         "size": 0,
         "precision_horz": 0,
         "precision_vert": 0
   }
}
  • 対象: SRV
    • JSON データ内の必須フィールドは type、data です。
      • data: - : service サービス種別。先頭にアンダースコアが付きます。 - : proto 有効なプロトコル。 - : priority 優先度。 - : weight レコードの重量。 - : port サービスのポート番号。 - : target 有効なホスト名。
      • オプション・フィールドは ttl です。

サンプル JSON データ:

{
   "type": "SRV",
   "data": {
         "service": "_ftp",
         "proto": "_tcp",
         "name": "testSRV",
         "priority": 1,
         "weight": 1,
         "port": 21,
         "target": "example.com"
   }
}
  • タイプ CAA の場合:
    • JSON データにおける必須フィールドは name、 type、、および です data。
    • オプション・フィールドは ttl です。

サンプル JSON データ:

{
   "name": "testCAA.yourdomain.com",
   "type": "CAA",
   "data": {
         "tag": "issue",
         "value": "letsencrypt.org"
   }
}
-s, --json-str
非推奨。 DNS レコードを説明するための JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン内にDNSレコードを作成します DNS_DOMAIN_ID。

ibmcloud cis dns-record-create DNS_DOMAIN_ID --json '{"name": "testCNAME", "type": "CNAME", "content": "example.com"}'
ibmcloud cis dns-record-create DNS_DOMAIN_ID --type A --name testA --content "127.0.0.1"

ibmcloud cis dns-record-update

サービスインスタンスのドメインの DNS レコードを更新します。

ibmcloud cis dns-record-update DNS_DOMAIN_ID DNS_RECORD_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis dns-record-update DNS_DOMAIN_ID DNS_RECORD_ID [--type TYPE] [--name NAME] [--content CONTENT] [--proxied PROXIED] [--ttl TTL] [--output FORMAT]
[Deprecated] ibmcloud cis dns-record-update DNS_DOMAIN_ID DNS_RECORD_ID --json-str JSON_STR [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis dns-record-update DNS_DOMAIN_ID DNS_RECORD_ID --json-file JSON_FILE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

DNS_RECORD_ID

DNSレコードのID。 必須。

--name

DNS レコード名。

--type

DNS レコード・タイプ。

--content

DNS レコード・コンテンツ。

--ttl

DNS レコードの存続時間。 値1は automatic. デフォルト値は1です。

--proxied

トラフィックが CIS 上のセキュリティー機能とパフォーマンス機能を通過するかどうかを制御します。 CIS は A、 AAAA、およびレコード CNAME のトラフィックのみをプロキシします。 有効な値は true と false です。

--json

DNSレコードを記述するために使用されるJSONファイルまたはJSON文字列。 サポートされる DNS レコード・タイプは A、AAAA、CNAME、NS、TXT、MX、LOC、SRV、CAA、PTR です。

  • タイプ A, AAAA, CNAME, NS, については: TXT
    • JSON データ内の必須フィールドは、name、type、content です。
    • オプションのフィールドは ttl および です: proxied
      • proxied トラフィックが CIS 上のセキュリティー機能とパフォーマンス機能を通過するかどうかを制御します。 CIS は A、 AAAA、およびの CNAME レコードに対するトラフィックのみをプロキシします。

サンプル JSON データ:

{
   "name": "testA",
   "type": "A",
   "content": "127.0.0.1",
   "proxied": true
}
{
   "name": "testAAAA",
   "type": "AAAA",
   "content": "2001:0db8:0012:0001:3c5e:7354:0000:5db1",
   "proxied": false
}
{
   "name": "testCNAME",
   "type": "CNAME",
   "content": "example.com"
}
{
   "name": "testNS",
   "type": "NS",
   "content": "ns1.example.com"
}
{
   "name": "testTXT",
   "type":"TXT",
   "content": "text information"
}
  • 対象: PTR
    • JSON データ内の必須フィールドは、name、type、content です。
    • オプション・フィールドは ttl です。

サンプル JSON データ:

{
 "name": "1.2.3.4",
 "type":"PTR",
 "content": "abc.test.com"
}
  • 対象: MX

    • JSON データ内の必須フィールドは、name、type、content です。
    • オプションのフィールドは ttl および です priority。

    サンプル JSON データ:

{
   "name": "testMX",
   "type": "MX",
   "content": "smtp.example.com",
   "priority": 10
}
  • 対象: LOC

    • JSON データ内の必須フィールドは、name、type、data です。
      • data:
        • lat_degrees: 緯度の度数。
        • lat_minutes: 許容誤差
        • lat_seconds: 緯度の秒。
        • lat_direction: 緯度・経度。
        • long_degrees: 経度。
        • long_minutes: 経度の分。
        • long_seconds: 経度の秒。
        • long_direction: 経度の方向。
        • altitude: 設置場所の標高(メートル単位)。
        • size: 場所の広さをメートル単位で表記。
        • precision_horz: 位置情報の水平方向の精度。
        • precision_vert: 位置の垂直方向の精度。
    • オプション・フィールドは ttl です。

    サンプル JSON データ:

{
   "name": "testLOC",
   "type": "LOC",
   "data": {
         "lat_degrees": 45,
         "lat_minutes": 0,
         "lat_seconds": 0,
         "lat_direction": "N",
         "long_degrees": 45,
         "long_minutes": 0,
         "long_seconds": 0,
         "long_direction": "E",
         "altitude": 20,
         "size": 0,
         "precision_horz": 0,
         "precision_vert": 0
   }
}
  • 対象: SRV

    • JSON データ内の必須フィールドは type、data です。
      • data:
        • service: サービス種別。先頭にアンダースコアが付きます。
        • proto: 有効なプロトコル。
        • priority: 優先度。
        • weight: レコードの重み。
        • port: サービスのポート。
        • target: 有効なホスト名。
    • オプション・フィールドは ttl です。

    サンプル JSON データ:

{
   "type": "SRV",
   "data": {
         "service": "_ftp",
         "proto": "_tcp",
         "name": "testSRV",
         "priority": 1,
         "weight": 1,
         "port": 21,
         "target": "example.com"
   }
}
  • 対象: CAA

    • JSON データにおける必須フィールドは name、 type、、 data
    • オプション・フィールドは ttl です。

    サンプル JSON データ:

{
   "name": "testCAA.yourdomain.com",
   "type": "CAA",
   "data": {
         "tag": "issue",
         "value": "letsencrypt.org"
   }
}
-s, --json-str
非推奨。 DNS レコードを説明するための JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン内のDNSレコードを更新します DNS_DOMAIN_ID。

ibmcloud cis dns-record-update DNS_DOMAIN_ID DNS_RECORD_ID --json '{"name": "testCNAME", "type": "CNAME", "content": "example.com"}'
ibmcloud cis dns-record-update DNS_DOMAIN_ID DNS_RECORD_ID --type A --name testA --content "127.0.0.1"

ibmcloud cis dns-record

サービスインスタンスに属するドメインの DNS レコードの詳細を取得します。

ibmcloud cis dns-record DNS_DOMAIN_ID DNS_RECORD_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
DNS_RECORD_ID
DNSレコードのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン内のDNSレコードの詳細を取得する DNS_DOMAIN_ID.

ibmcloud cis dns-record DNS_DOMAIN_ID DNS_RECORD_ID

ibmcloud cis dns-record-delete

サービスインスタンスのドメインの DNS レコードを削除します。

ibmcloud cis dns-record-delete DNS_DOMAIN_ID DNS_RECORD_ID [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
DNS_RECORD_ID
DNSレコードのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ドメイン内のDNSレコードを削除する DNS_DOMAIN_ID。

ibmcloud cis dns-record-delete DNS_DOMAIN_ID DNS_RECORD_ID

ibmcloud cis dns-records

サービスインスタンスのドメインに関するすべてのDNSレコードを一覧表示します。

ibmcloud cis dns-records DNS_DOMAIN_ID [--type TYPE] [--name NAME] [--content CONTENT] [--page PAGE] [--per-page PER_PAGE] [--order ORDER] [--direction DIRECTION] [--match MATCH] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--type
表示する DNS レコードのタイプ。
--name
フィルターで使用する名前フィールドの値。
--content
フィルターで使用するコンテンツ・フィールドの値。
--page
ページ番号付けした結果のページ番号。
--per_page
ページあたりの最大 DNS レコード数。
--order
DNSレコードのリストを並べ替えるための基準となるフィールド。 有効な値は type、 name、 content、 ttl、 および です proxied。
--direction
検索結果の並べ替え順序(昇順または降順)。 有効な値は asc および desc です。
--match
検索パラメータをすべて一致させるか、少なくとも1つを一致させるか。 有効な値は any および all です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン内のすべてのDNSレコードを一覧表示します DNS_DOMAIN_ID。

ibmcloud cis dns-records DNS_DOMAIN_ID

ibmcloud cis dns-records-import

BIND 構成をインポートします。

ibmcloud cis dns-records-import DNS_DOMAIN_ID --file FILE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--file
インポートする BIND 構成。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン内のBINDコンフィグをインポートする DNS_DOMAIN_ID.

ibmcloud cis dns-records-import DNS_DOMAIN_ID --file bind_config_file.txt

ibmcloud cis dns-records-export

エクスポート BIND 構成。

ibmcloud cis dns-records-export DNS_DOMAIN_ID [--file FILE] [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--file
エクスポートされたDNSレコードを保存するBIND設定ファイル。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ドメインの BIND 設定をエクスポートする DNS_DOMAIN_ID。

ibmcloud cis dns-records-export DNS_DOMAIN_ID --file bind_config_file.txt

ドメイン

以下の domain コマンドを使用して、ドメインを扱います。

ibmcloud cis domain-add

ドメインを追加します。

ibmcloud cis domain-add DNS_DOMAIN_NAME [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

type

ドメイン・タイプのセットアップを指定してください。 有効な値は full と partial (デフォルトは full )。

  • full: フルゾーンとは、DNSがホストされていることを意味します。
  • partial: 部分ゾーンとは、CNAME 設定がされたドメインを意味します。
jump-start

自動的に既存の DNS レコードの取り出しを試みます。

DNS_DOMAIN_NAME

DNS ドメインの FQDN。 必須。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインを追加する DNS_DOMAIN_NAME。

ibmcloud cis domain-add DNS_DOMAIN_NAME

ibmcloud cis domain-resume

ドメインを再開する。

ibmcloud cis domain-resume DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

指定されたドメインを再開します。

ibmcloud cis domain-resume DNS_DOMAIN_ID

ibmcloud cis domain-pause

ドメインを一時停止します。

ibmcloud cis domain-pause DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

指定されたドメインを一時停止します。

ibmcloud cis domain-pause DNS_DOMAIN_ID

ibmcloud cis domain

ドメインの詳細を表示します。

ibmcloud cis domain DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

指定されたドメインの詳細を表示します。

ibmcloud cis domain DNS_DOMAIN_ID

ibmcloud cis domain-remove

ドメインを削除します。

ibmcloud cis domain-remove DNS_DOMAIN_ID [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

指定されたドメインを削除します。

ibmcloud cis domain-remove DNS_DOMAIN_ID

ibmcloud cis domains

サービスインスタンスのドメインを一覧表示します。

ibmcloud cis domains [--instance INSTANCE_NAME] [--output FORMAT]

コマンド・オプション

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

サービスインスタンスのドメインを一覧表示します。

ibmcloud cis domains

ibmcloud cis domain-activation-check

ドメインのアクティベーションを確認してください。

ibmcloud cis domain-activation-check DNS_DOMAIN_ID [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

指定されたドメインでアクティベーション・チェックを実行します。

ibmcloud cis domain-activation-check DNS_DOMAIN_ID

ドメイン設定

以下のコマンド domain-settings を使用して、ドメイン設定を変更します:

ibmcloud cis domain-settings

ドメインの機能の詳細を取得します。

ibmcloud cis domain-settings DNS_DOMAIN_ID [-g, --group GROUP | -f, --feature FEATURE] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-g, --group
同じグループの機能を表示します。 の有効な値は all、 domain、 reliability、、 performance、および group です security。 このオプションは、-f, --feature と同時には使用できません。
-f, --feature
確認するドメイン設定の機能。 このオプションは、g, --group と同時には使用できません。 有効な値は次のとおりです。
  • always_use_https: スキーマを含むすべてのリクエストを http にリダイレクトしてください https。 この設定は、当該ドメインに対するすべての HTTP リクエストに適用されます。
  • automatic_https_rewrites: HTTPS で配信可能なウェブサイト上のすべてのリソースやリンクについて https 、 http を に変更することで、混合コンテンツの問題を解消してください。
  • bot_management: ドメイン上のボットトラフィックを検知し、その影響を軽減します。
  • brotli: アセットをリクエストしているクライアントが Brotli 圧縮アルゴリズムに対応している場合、 CIS はそのアセットの Brotli 圧縮版を配信します。
  • browser_check: 訪問者のブラウザから送信される HTTP ヘッダーを分析し、脅威の有無を評価します。 脅威が検出された場合、ブロックページが配信されます。
  • challenge_ttl: IPレピュテーションが不良な訪問者が、認証プロセスを完了した後、どのくらいの期間、ウェブサイトへのアクセスが許可されるかを指定します。
  • ciphers: BoringSSL 形式の、 TLS ターミネーション用暗号スイートの許可リスト。 このコマンドは、顧客によって許可リストに登録された暗号をリストアップします。 許可リストに登録された暗号方式がない場合、リストは空となり、デフォルトの暗号方式が使用されます。 デフォルトの暗号化方式の一覧は、 Edge暗号スイート と Origin暗号スイート を参照してください。
  • cname_flattening: CNAME が指す先を追跡し、CNAME レコードの代わりにその IP アドレスを返す。 デフォルトでは、ドメインのルートにある CNAME のみをフラット化します。
  • domain_hold: ドメインの保持機能により、組織内のチームが、別のアカウントですでに有効になっているドメインを追加することを防ぎます。 Enterprise Plans Only
  • email_obfuscation ボットからはウェブページ上のメールアドレスを暗号化し、人間からは見えるようにします。
  • opportunistic_onion: Tor Browserの正当なユーザーが貴社のウェブサイトにアクセスできるようにしてください。
  • hotlink_protection: 画像が外部サイトからリンクされるのを防ぎましょう。
  • http2: HTTP/2 を利用してウェブサイトの高速化を実現しましょう。
  • http3: HTTP/3 を利用してウェブサイトの高速化を実現しましょう。
  • image_load_optimization 非推奨。 低速なネットワークに接続するモバイル・デバイス上のイメージを含むページのロード時間を改善します。
  • image_size_optimization: ドメイン上でホストされている画像を最適化することで、画像の読み込み時間を短縮します。
  • image_resizing CIS ネットワークを通じて提供される画像のリサイズ、変換、最適化をオンデマンドで提供。
  • ip_geolocation: ウェブサイトへのすべてのリクエストには、訪問者の所在地の国コードを含めてください。
  • ipv6: IPv6 のサポートとゲートウェイを有効にします。
  • max_upload: 1回のリクエストでウェブサイトにデータをアップロードできる訪問者の数。
  • min_tls_version: 選択した TLS プロトコルバージョン以降をサポートする訪問者からの HTTPS 接続のみを許可します。
  • minify: ウェブサイト上のソースコードのファイルサイズを縮小してください。
  • mobile_redirect: モバイル端末を利用している訪問者を、モバイル向けに最適化されたWebサイトにリダイレクトします。
  • opportunistic_encryption: オポチュニスティック暗号化により、ブラウザに対してサイトが暗号化された接続で利用可能であることを通知することで、 HTTP/2 のパフォーマンス向上をブラウザが活用できるようになります。
  • origin_error_page_pass_thru: 「オリジンエラーページ」が On に設定されている場合、 CIS は 502 および 504 のエラーページをオリジンから直接プロキシします。 Enterprise Plans Only
  • origin_max_http_version: HTTP バージョンをOriginに設定します。
  • origin_post_quantum_encryption: CIS に対し、お客様のオリジンに接続する際には、ポスト量子(PQ)鍵合意アルゴリズムを使用するよう指示します。
  • prefetch_preload: CIS は、prefetch HTTP ヘッダーに含まれるすべての URL をプリフェッチします。 Enterprise Plans Only
  • pseudo_ipv4: クライアントが IPv6 を使用しているものの、サーバーが IPv4 のみをサポートしている場合、リクエストに IPv4 ヘッダーを追加します。
  • response_buffering: オリジンサーバーからの応答のバッファリングを有効または無効にします。 Enterprise Plans Only
  • script_load_optimization: JavaScript を含むページの描画時間を改善する。
  • security_header: ウェブサイトに対してWebセキュリティポリシーを適用してください。
  • security_level: ウェブサイトに適したセキュリティプロファイルを選択してください。
  • server_side_exclude: 不審な訪問者に対して、特定のコンテンツを自動的に非表示にします。
  • tls_client_auth: オリジンからのプル時に、認証のために提示された TLS のクライアント証明書。 Enterprise Plans Only
  • true_client_ip_header: CIS は、True-Client-IP ヘッダーにユーザーの IP アドレスを送信します。 Enterprise Plans Only
  • waf: Webアプリケーションファイアウォール(WAF)は、悪意のあるコンテンツを含むリクエストをブロックします。
  • websockets: オリジンサーバーへの WebSockets 接続を許可します。
  • proxy_read_timeout: オリジンからの2回の読み取り操作間の最大時間。 Enterprise Plans Only
  • url_normalization: 受信リクエストのURLを変更します。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン ciphers の設定を取得する DNS_DOMAIN_ID。

ibmcloud cis domain-settings DNS_DOMAIN_ID -f ciphers

ibmcloud cis domain-settings-update

ドメインの機能を更新します。

ibmcloud cis domain-settings-update DNS_DOMAIN_ID (-f, --feature FEATURE) (-v, --value VALUE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-f, --feature
更新対象のドメイン設定の機能。 必須。 有効値:
  • always_use_https: スキーマを含むすべてのリクエストを http にリダイレクトしてください https。 このリダイレクトは、当該ドメインへのすべての HTTP リクエストに適用されます。
  • automatic_https_rewrites: HTTPS で配信可能なウェブサイト上のすべてのリソースやリンクについて https 、 http を に変更することで、混合コンテンツの問題を解消してください。
  • bot_management: ドメイン上のボットトラフィックを検知し、その影響を軽減します。
  • brotli: アセットをリクエストしているクライアントが Brotli 圧縮アルゴリズムに対応している場合、 CIS はそのアセットの Brotli 圧縮版を配信します。
  • browser_check: 訪問者のブラウザから送信される HTTP ヘッダーを分析し、脅威の有無を評価します。 脅威が検出された場合、ブロックページが配信されます。
  • challenge_ttl: IPレピュテーションが不良な訪問者が、認証プロセスを完了した後、どのくらいの期間、ウェブサイトへのアクセスが許可されるかを指定します。
  • ciphers TLS の終了のための暗号の許可リスト。 これらの暗号は BoringSSL フォーマットである必要があります。
  • cname_flattening: CNAME が指す先を追跡し、CNAME レコードの代わりにその IP アドレスを返す。 デフォルトでは、自分のドメインのルートにある CNAME のみをフラット化します。
  • domain_hold: ドメインの保持機能により、組織内のチームが、別のアカウントですでに有効になっているドメインを追加することを防ぎます。 Enterprise Plans Only
  • email_obfuscation ボットからはウェブページ上のメールアドレスを暗号化し、人間からは見えるようにします。
  • opportunistic_onion: Tor Browserの正当なユーザーが貴社のウェブサイトにアクセスできるようにしてください。
  • hotlink_protection: 画像が外部サイトからリンクされるのを防ぎましょう。
  • http2: HTTP/2 を利用してウェブサイトの高速化を実現しましょう。
  • http3: HTTP/3 を利用してウェブサイトの高速化を実現しましょう。
  • image_load_optimization 非推奨。 低速なネットワークに接続するモバイル・デバイス上のイメージを含むページのロード時間を改善します。
  • image_size_optimization: ドメイン上でホストされている画像を最適化することで、画像の読み込み時間を短縮します。
  • image_resizing CIS ネットワークを通じて提供される画像のリサイズ、変換、最適化をオンデマンドで提供。
  • ip_geolocation: ウェブサイトへのすべてのリクエストには、訪問者の所在地の国コードを含めてください。
  • ipv6: IPv6 のサポートとゲートウェイを有効にします。
  • max_upload: 1回のリクエストでウェブサイトにデータをアップロードできる訪問者の数。
  • min_tls_version: 選択した TLS プロトコルバージョン以降をサポートする訪問者からの HTTPS 接続のみを許可します。
  • minify: ウェブサイト上のソースコードのファイルサイズを縮小してください。
  • mobile_redirect: モバイル端末を利用している訪問者を、モバイル向けに最適化されたWebサイトにリダイレクトします。
  • opportunistic_encryption: オポチュニスティック暗号化により、ブラウザに対してサイトが暗号化された接続で利用可能であることを通知することで、 HTTP/2 のパフォーマンス向上をブラウザが活用できるようになります。
  • origin_error_page_pass_thru: Origin Error Pageが に設定されている場合 On、 CIS は502および504エラーページをオリジンから直接プロキシします。 Enterprise Plans Only
  • origin_max_http_version: HTTP バージョンをOriginに設定します。
  • origin_post_quantum_encryption: CIS に対し、お客様のオリジンに接続する際には、ポスト量子(PQ)鍵合意アルゴリズムを使用するよう指示します。
  • prefetch_preload: CIS は、prefetch HTTP ヘッダーに含まれるすべての URL をプリフェッチします。 Enterprise Plans Only
  • pseudo_ipv4: クライアントが IPv6 を使用しているものの、サーバーが IPv4 のみをサポートしている場合、リクエストに IPv4 ヘッダーを追加します。
  • response_buffering: オリジンサーバーからの応答のバッファリングを有効または無効にします。 Enterprise Plans Only
  • script_load_optimization: JavaScript を含むページの描画時間を改善する。
  • security_header: ウェブサイトに対してWebセキュリティポリシーを適用してください。
  • security_level: ウェブサイトに適したセキュリティプロファイルを選択してください。
  • server_side_exclude: 不審な訪問者に対して、特定のコンテンツを自動的に非表示にします。
  • tls_client_auth: オリジンからのプル時に、認証のために提示された TLS のクライアント証明書。 Enterprise Plans Only
  • true_client_ip_header: CIS は、True-Client-IP ヘッダーにユーザーの IP アドレスを送信します。 Enterprise Plans Only
  • waf: Webアプリケーションファイアウォール(WAF)は、悪意のあるコンテンツを含むリクエストをブロックします。
  • websockets: オリジンサーバーへの WebSockets 接続を許可します。
  • proxy_read_timeout: オリジンからの2回の読み取り操作間の最大時間。
  • url_normalization: 受信リクエストのURLを変更します。
-v, --value
ドメインの機能に設定される値。 必須。
  • の有効な値は および on です always_use_https``off。

  • の有効な値は および on です automatic_https_rewrites``off。

  • bot_management の有効な値は、「use_latest_model」、「fight_mode」、「session_score」、「enable_js」です。 例: -v fight_mode=true,session_score=true

    • use_latest_model 最新バージョンを有効にするかどうか。 の有効な値は および true です use_latest_model``false。
    • fight_mode ファイトモードを有効にするかどうか。 の有効な値は および true です fight_mode``false。
    • session_score セッションスコアを有効にするかどうか。 の有効な値は および true です session_score``false。
    • enable_js JavaScript の検出を有効にするかどうか。 の有効な値は および true です enable_js``false。
  • の有効な値は および on です browser_check``off。

  • challenge_ttl の有効な値は、300, 900, 1800, 2700, 3600, 7200, 10800, 14400, 28800, 57600, 86400, 604800, 2592000, 31536000 です。

  • cname_flattening の有効な値は、flatten_at_root、flatten_all です。

    • flatten_at_root: ルートドメインで CNAME をフラット化します。 この値はデフォルト値です。
    • flatten_all: ドメイン下のすべての CNAME レコードをフラット化してください。
  • domain_hold の有効な値は hold、 include_subdomains 、 hold_after である。

    • hold ドメインホールドを有効にするかどうか。 の有効な値は および true です hold``false。
    • include_subdomains ドメインホールドを有効にするかどうか。 の有効な値は および true です include_subdomains``false。
    • hold_after: が指定 hold_after された場合、保留は一時的に無効化され、指定された時刻にシステムによって自動的に再有効化されます。

    有効なドメインおよびサブドメインは以下の通りです: -v hold=true,include_subdomains=true. ドメイン保留を無効にするには: -v hold=false,hold_after=2023-05-31T15:56:36+00:00。

  • hotlink_protection の有効な値は、on、off です。

  • email_obfuscation の有効な値は、on、off です。

  • opportunistic_onion の有効な値は、on、off です。

  • http2 の有効な値は、on、off です。

  • http3 の有効な値は、on、off です。

  • 非推奨。 image_load_optimization の有効な値は、on、off です。

  • image_resizing の有効な値は、on、off です。

  • image_size_optimization の有効な値は、off、lossless、lossy です。

    • off: イメージ・サイズの最適化を無効にします。
    • lossless: 画質を損なうことなく、画像ファイルのサイズを縮小します。
    • lossy: JPEG 画像のファイルサイズは、非可逆圧縮を使用することで縮小されますが、これにより画質が低下する可能性があります。
  • ip_geolocation の有効な値は、on、off です。

  • ipv6 の有効な値は、on、off です。

  • max_upload の有効な値 (MB 単位) は以下のとおりです。 100, 125, 150, 175, 200 and 225, 250, 275, 300, 325, 350, 375, 400, 425, 450, 475, 500. Enterprise Plans Only

  • min_tls_version の有効な値は、1.0、1.1、1.2、1,3 です。

  • minify の有効な値は、 css、 html、 js です。例えば、 -v css=on,html=off,js=on

    • css: ウェブサイトのすべてのCSSを自動的に圧縮します。 css の有効な値は、on、off です。
    • html: ウェブサイトのすべてのHTMLを自動的に縮小します。 html の有効な値は、on、off です。
    • js: ウェブサイトのすべてのJSを自動的にミニファイします。 js の有効な値は、on、off です。
  • mobile_redirect の有効な値は、 status、 mobile_subdomain、 strip_uriです。 例えば、 -v status=on,mobile_subdomain=m,strip_uri=true のように指定します。

    • status: モバイルリダイレクトが有効になっているかどうか。 の有効な値は および on です status``off。
    • mobile_subdomain: モバイル端末からの訪問者をどのサブドメインのプレフィックスにリダイレクトするか(サブドメインは存在している必要があります)。
    • strip_uri: 現在のページパスを削除し、モバイルサブドメインの URL ルートへリダイレクトするかどうか。 strip_uri の有効な値は、true、false です。
  • opportunistic_encryption の有効な値は、on、off です。

  • origin_error_page_pass_thru の有効な値は、1、2 です。

  • origin_max_http_version の有効な値は、supported、preferred、off です。

    • supported: ポスト量子アルゴリズムは宣伝されていますが、送信元からの要求があった場合にのみ使用されます。
    • preferred: Preferredを指定すると、 CIS は、オリジンがPQをサポートし、かつPQを優先する場合に最速の接続を実現できるよう、最初のメッセージでポスト量子(PQ)キーシェアを適宜送信するよう指示されます。
    • off:ポスト量子アルゴリズムについては宣伝を行っていません。
  • origin_post_quantum_encryption の有効な値は、on、off です。

  • brotli の有効な値は、on、off です。

  • prefetch_preload の有効な値は、on、off です。

  • pseudo_ipv4 の有効な値は、off、add_header、overwrite_header です。

    • off: Pseudo IPv4 を無効にします。
    • add_header: Cf-Pseudo-IPv4 ヘッダーのみを追加してください。
    • overwrite_header: 既存の Cf-Connecting-IP と X-Forwarded-For ヘッダーを Pseudo IPv4 アドレスで上書きします。
  • response_buffering の有効な値は、on、off です。

  • script_load_optimization の有効な値は、on、off です。

  • security_header の有効な値は、 enabled、 max_age、 include_subdomains、 preload、 nosniff です。例えば、 -v enabled=true,max_age=100、include_subdomains=true、preload=true、nosniff=true

    • enabled security_header が有効かどうか。 enabled の有効な値は、true、false です。
    • max_age: ブラウザで security_header がキャッシュされる期間(秒単位)を指定します。
    • include_subdomains: 当該ドメインの下位にあるすべてのドメインは、同じ security_header を継承します。 include_subdomains の有効な値は、true、false です。
    • preload: ブラウザによる security_header 設定のプリロードを許可するかどうか。 enabled の有効な値は、true、false です。
    • nosniff: X-Content-Type-Options: nosniff ヘッダーを送信するかどうか。 nosniff の有効な値は、true、false です。
  • server_level の有効な値は、 off、 essentially_off、 low、 medium、 high、 under_attackです。

  • server_side_exclude の有効な値は、on、off です。

  • tls_client_auth の有効な値は、on、off です。

  • true_client_ip_header の有効な値は、on、off です。

  • waf の有効な値は、on、off です。

  • websockets の有効な値は、on、off です。

  • の有効な値は 1~6000 proxy_read_timeout、デフォルト値は 125 です。

  • ciphers の有効な値は、 ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-ECDSA-CHACHA20-POLY1305, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-CHACHA20-POLY1305, ECDHE-ECDSA-AES128-SHA256, ECDHE-ECDSA-AES128-SHA, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES128-SHA, AES128-GCM-SHA256, AES128-SHA256, AES128-SHA, ECDHE-ECDSA-AES256-GCM-SHA384, ECDHE-ECDSA-AES256-SHA384, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-RSA-AES256-SHA384, ECDHE-RSA-AES256-SHA, AES256-GCM-SHA384, AES256-SHA256, AES256-SHA, DES-CBC3-SHA, default である。例えば、 -v AES256-SHA256,AES256-SHA、 -v default を使用して、設定済みの暗号スイートをデフォルト値にリセットする。

  • url_normalization の有効な値は「type」、「scope」です。 例えば、 -v type=cis,scope=both

    • type: CIS によって実行される URL 正規化のタイプを選択します。 type の有効な値は、cis、rfc3986 です。
    • scope: URL 正規化の範囲を設定します。 scope の有効な値は、both、incoming です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン. tls_client_auth に対して有効にする DNS_DOMAIN_ID。

ibmcloud cis domain-settings-update DNS_DOMAIN_ID -f tls_client_auth -v on

エッジ機能

以下のコマンド edge-functions を使用して、Edge Functions の動作を制御します:

ibmcloud cis edge-functions-actions

サービス・インスタンスのすべての Edge Functions アクションをリストします。

ibmcloud cis edge-functions-actions [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

Edge Functions のすべてのアクションを一覧表示します。

ibmcloud cis edge-functions-actions

ibmcloud cis edge-functions-action

サービス・インスタンスの Edge Functions アクションを表示します。

ibmcloud cis edge-functions-action [--name ACTION_NAME] [-i, --instance INSTANCE]

コマンド・オプション

--name
アクション名。 Enterprise Plans Only
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

Edge Functions アクションの詳細を表示します ACTION_NAME。

ibmcloud cis edge-functions-action --name ACTION_NAME

ibmcloud cis edge-functions-action-create

サービス・インスタンスの Edge Functions アクションを作成します。

ibmcloud cis edge-functions-action-create [--name ACTION_NAME] (--javascript-str JAVASCRIPT_STR | --javascript-file JAVASCRIPT_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--name
アクション名。 Enterprise Plans Only
--javascript-str
Javascript ストリング。 例: addEventListener('fetch', event => { event.respondWith(fetch(event.request))})
--javascript-file
Javascript ファイル。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

Edge Functions アクションを作成します。

ibmcloud cis edge-functions-action-create --name ACTION_NAME --javascript-str "addEventListener('fetch', event => { event.respondWith(fetch(event.request)) })"

ibmcloud cis edge-functions-action-update

サービス・インスタンスの Edge Functions アクションを更新します。

ibmcloud cis edge-functions-action-update (--javascript-str JAVASCRIPT_STR | --javascript-file JAVASCRIPT_FILE) [--name ACTION_NAME] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--name
アクション名。 Enterprise Plans Only
--javascript-str
Javascript ストリング。 例: addEventListener('fetch', event => { event.respondWith(fetch(event.request))})
--javascript-file
Javascript ファイル。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

Edge Functions アクションを更新します。

ibmcloud cis edge-functions-action-update --name ACTION_NAME --javascript-str "addEventListener('fetch', event => { event.respondWith(fetch(event.request)) })"

ibmcloud cis edge-functions-action-delete

サービス・インスタンスの Edge Functions アクションを削除します。

ibmcloud cis edge-functions-action-delete [--name ACTION_NAME] [-i, --instance INSTANCE]

コマンド・オプション

--name
アクション名。 Enterprise Plans Only
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

Edge Functionsアクションを削除します ACTION_NAME。

ibmcloud cis edge-functions-action-delete --name ACTION_NAME

ibmcloud cis edge-functions-triggers

サービスインスタンスのドメインに対するすべての Edge Functions トリガーを一覧表示します。

ibmcloud cis edge-functions-triggers DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン. のすべての Edge Functions トリガーを一覧表示します DNS_DOMAIN_ID。

ibmcloud cis edge-functions-triggers DNS_DOMAIN_ID

ibmcloud cis edge-functions-trigger

サービスインスタンスのドメインに対する Edge Functions トリガーを表示します。

ibmcloud cis edge-functions-trigger DNS_DOMAIN_ID TRIGGER_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
TRIGGER_ID
トリガーのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

Edge Functionsのトリガーの詳細を表示します TRIGGER_ID。

ibmcloud cis edge-functions-trigger DNS_DOMAIN_ID TRIGGER_ID

ibmcloud cis edge-functions-trigger-create

サービスインスタンスのドメインに対して、Edge Functions トリガーを作成します。

ibmcloud cis edge-functions-trigger-create DNS_DOMAIN_ID PATTERN_URL [--name ACTION_NAME] [--disable] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
PATTERN_URL
アクションをトリガーするリクエスト URL。 必須。
name
作成されたトリガーが関連付けられるアクション名。 Enterprise Plans Only
disable
Edge Functions トリガーを無効にします。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン.用の Edge Functions トリガーを作成します DNS_DOMAIN_ID。

ibmcloud cis edge-functions-trigger-create DNS_DOMAIN_ID PATTERN_URL --name ACTION_NAME

ibmcloud cis edge-functions-trigger-update

サービスインスタンスのドメインに対する Edge Functions トリガーを更新します。

ibmcloud cis edge-functions-trigger-update DNS_DOMAIN_ID TRIGGER_ID PATTERN_URL [--name ACTION_NAME] [--disable] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
TRIGGER_ID
トリガーのID。 必須。
PATTERN_URL
アクションをトリガーするリクエスト URL。 必須。
name
作成されたトリガーが紐付けられるアクション名。 Enterprise Plans Only
disable
Edge Functions トリガーを無効にします。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

Edge Functionsのトリガーを更新します TRIGGER_ID。

ibmcloud cis edge-functions-trigger-update DNS_DOMAIN_ID TRIGGER_ID PATTERN_URL --name ACTION_NAME

ibmcloud cis edge-functions-trigger-delete

サービスインスタンスのドメインに対する Edge Functions トリガーを削除します。

ibmcloud cis edge-functions-trigger-delete DNS_DOMAIN_ID TRIGGER_ID [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
TRIGGER_ID
トリガーのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

Edge Functions トリガーを削除します TRIGGER_ID。

ibmcloud cis edge-functions-trigger-delete DNS_DOMAIN_ID TRIGGER_ID

ファイアウォール(非推奨)

ファイアウォールルールは非推奨となっています。 CIS 既存のファイアウォールルールを WAFのカスタムルール に移動しました。 まだWAFのカスタムルールへの移行を行っていない場合は、移行を妨げる無効な設定がある可能性があります。 その場合は、 アカウント担当チームにご連絡いただき、WAFのカスタムルールへの移行についてサポートを受けてください。 詳細については、「 WAFのカスタムルールへの移行 」を参照してください。

以下の firewall コマンドを使用して、ファイアウォールを扱います。

ibmcloud cis firewall-create

新規ファイアウォール・ルールを作成します。

ibmcloud cis firewall-create (-t, --type Type) (--json @JSON_FILE | JSON_STRING) [-d, --domain DNS_DOMAIN_ID] [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis firewall-create (-t, --type Type) (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-d, --domain DNS_DOMAIN_ID] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

-t, --type
作成するファイアウォールルールの種類。 有効な値: access-rules、 ua-rules、 lockdowns。必須。
  • access-rules: アクセス・ルールは、Web サイトへの要求を許可、チャレンジ、ブロックするための方法です。 アクセス・ルールは、1 つのドメインのみ、または同じサービス・インスタンス内のすべてのドメインに適用できます。
  • ua-rules: クライアントによって報告された UserAgent と厳密に一致させるときは、アクセス制御を実行します。 特定のクライアントからのトラフィックを管理するように、ルール内でアクセス制御メカニズムを定義できます。 このオプションを使用すると、サイトへのアクセスをカスタマイズできます。
  • lockdowns: このドメインの URL へのアクセスをロックして、許可されたアドレスまたはアドレス範囲のみに限定します。
-d, --domain
DNS ドメイン ID。 ua-rules および lockdowns タイプのルールの場合、これは必須パラメーターです。
--json
ファイアウォールルールを記述するために使用される JSON ファイルまたは JSON 文字列。 必須。
  • 対象: --type access-rules ファイアウォールのアクセスルールを以下のように記述する JSON データ。
    • 必須フィールドは、mode、configuration です。
      • mode: 実行すべきアクションの種類。 有効な値は block、 challenge、 whitelist、 です js_challenge。
      • configuration: このルールに使用するターゲット/値のペア。
        • target: 対象とするリクエストプロパティ。 有効な値は ip、 ip_range、 asn、 です country。
        • value: 選択されたターゲットの値。
          • ip の場合、その値は有効な IP アドレスです。
          • ip_range の値は、~ /16 および~に限定された IP 範囲を指定します /24。
          • asn の場合、その値は AS 番号です。
          • 国については、その国の国コードが値となります。
    • オプション・フィールドは notes です。
      • notes: このルールの目的を把握するのに役立つ、いくつかの有用な情報。

サンプル JSON データ:

{
   "mode": "block",
   "notes": "This rule is added because of event X that occurred on date xyz",
   "configuration": {
      "target": "ip",
      "value": "127.0.0.1"
   }
}
  • 対象: --type ua-rules ユーザーエージェント・ルールを以下のように記述する JSON データ。
    • 必須フィールドは、mode、configuration です。
      • mode: 実行すべきアクションの種類。 有効な値は block、 challenge、 js_challenge である。
      • configuration: このルールに使用するターゲット/値のペア。
        • target: 対象とするリクエストプロパティ。 有効な値は です ua。
        • value: このルールに一致させるための正確な UserAgent 文字列。
    • オプション・フィールドは、paused、description です。
      • paused: このルールが現在無効になっているかどうか。
      • description: このルールの目的を把握するのに役立つ、いくつかの有用な情報。

サンプル JSON データ:

{
   "mode": "block",
   "configuration": {
      "target": "ua",
      "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"
   }
}
  • --type lockdowns :ロックダウン・ルールを記述するJSONデータは以下の通り。
    • 必須フィールドは、urls、configurations です。
      • urls: このルール定義に含めるURL。
        • ワイルドカードを使用できます。
        • ここに入力した URL パターンは使用前にエスケープされます。
        • このフィールドでは、 URL を単純なワイルドカードパターンに制限します。
      • configurations: このルールで使用するIPアドレスまたはCIDR範囲のリスト。
        • このフィールドには、指定されたURLにアクセスできるIPアドレスまたはIPアドレス範囲の設定を、いくつでも含めることができます。
        • target: 対象とするリクエストプロパティ。 有効な値は ip および ip_range。
        • value: IPアドレスまたはCIDR。 対象が の場合 ip、値は IP アドレスでなければなりません。それ以外の場合は CIDR である必要があります。
    • オプション・フィールドは、paused、description です。
      • paused: このルールが現在無効になっているかどうか。
      • description: このルールの目的を把握するのに役立つ、いくつかの有用な情報。

サンプル JSON データ:

{
   "urls": [
      "api.mysite.com/some/endpoint*"
   ],
   "configurations": [
      {
         "target": "ip",
         "value": "127.0.0.1"
      },
      {
         "target": "ip_range",
         "value": " 2.2.2.0/24"
      }
   ]
}
-s, --json-str
非推奨。 ファイアウォール・ルールを記述する JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ファイアウォール・ルールを作成します。

ibmcloud cis firewall-create --type access-rules --json '{"mode": "block", "notes": "This rule is added because of event X that occurred on date xyz", "configuration": {"target": "ip", "value": "127.0.0.1"}}' --instance INSTANCE
ibmcloud cis firewall-create --type ua-rules --domain DNS_DOMAIN_ID --json '{"mode": "block", "configuration": {"target": "ua", "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"}}' --instance INSTANCE
ibmcloud cis firewall-create --type lockdowns --domain DNS_DOMAIN_ID --json '{"urls": ["api.mysite.com/some/endpoint*"], "configurations": [{"target": "ip", "value": "127.0.0.1"}, {"target": "ip_range", "value": "2.2.2.0/24"}]}' --instance INSTANCE

ibmcloud cis firewall-update

ファイアウォール・ルールを更新します。

ibmcloud cis firewall-update FIREWALL_RULE_ID (-t, --type Type) (--json @JSON_FILE | JSON_STRING) [-d, --domain DNS_DOMAIN_ID] [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis firewall-update FIREWALL_RULE_ID (-t, --type Type) (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-d, --domain DNS_DOMAIN_ID] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

  • FIREWALL_RULE_ID: ファイアウォール・ルールの ID。 必須。
-t, --type

作成するファイアウォールルールの種類。 有効な値は access-rules、 ua-rules、 lockdowns。 必須。

  • access-rules: アクセスルールは、Webサイトへのリクエストを許可、検証、またはブロックするための手段です。 アクセス・ルールは、1 つのドメインのみ、または同じサービス・インスタンス内のすべてのドメインに適用できます。
  • ua-rules: クライアントから報告された UserAgent と完全に一致する場合に、アクセス制御を実行します。 特定のクライアントからのトラフィックを管理するように、ルール内でアクセス制御メカニズムを定義できます。 これにより、サイトへのアクセスをカスタマイズできるようになります。
  • lockdowns: このドメイン内のURLへのアクセスを、許可されたアドレスまたはアドレス範囲のみに制限します。
-d, --domain

DNS ドメイン ID。 ua-rules および lockdowns タイプのルールの場合、これは必須パラメーターです。

--json

ファイアウォールルールを記述するために使用される JSON ファイルまたは JSON 文字列。 必須。

  • --type access-rules の場合:ファイアウォールのアクセスルールを記述するJSONデータは以下の通り。
    • オプション・フィールドは、mode、notes です。
      • mode: 実行すべきアクションの種類。 有効な値は block、 challenge、 whitelist、 です js_challenge。
      • notes: このルールの目的を把握するのに役立つ、いくつかの有用な情報。

サンプル JSON データ:

{
   "mode": "challenge",
   "notes": "This rule is added because of event X that occurred on date xyz",
}
  • --type ua-rules :ユーザー・エージェント・ルールを記述するJSONデータは以下の通り。

    • 必須フィールドは、mode、configuration です。
      • mode: 実行すべきアクションの種類。 有効な値は block、 challenge、 js_challenge である。
      • configuration: このルールに使用するターゲット/値のペア。
        • target: 対象とするリクエストプロパティ。 有効な値は です ua。
        • value: このルールに一致させるための正確な UserAgent 文字列。
    • オプション・フィールドは、paused、description です。
      • paused: このルールが現在無効になっているかどうか。
      • description: このルールの目的を把握するのに役立つ、いくつかの有用な情報。

    サンプル JSON データ:

{
   "mode": "block",
   "configuration": {
      "target": "ua",
      "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"
   }
}
  • --type lockdowns :ロックダウン・ルールを記述するJSONデータは以下の通り。
    • 必須フィールドは、urls、configurations です。
      • urls: このルール定義に含めるURL。
        • ワイルドカードを使用できます。
        • ここに入力した URL パターンは使用前にエスケープされます。
        • このフィールドでは、 URL を単純なワイルドカードパターンに制限します。
      • configurations: このルールで使用するIPアドレスまたはCIDR範囲のリスト。
        • このフィールドには、指定されたURLにアクセスできるIPアドレスまたはIPアドレス範囲の設定を、いくつでも含めることができます。
        • target: 対象とするリクエストプロパティ。 有効な値は ip と ip_range。
        • value: IPアドレスまたはCIDR。 対象が である場合は ip、値は IP アドレスでなければなりません。それ以外の場合は CIDR です。
    • オプション・フィールドは、paused、description です。
      • paused: このルールが現在無効になっているかどうか。
      • description: このルールの目的を把握するのに役立つ、いくつかの有用な情報。

サンプル JSON データ:

{
   "urls": [
      "api.mysite.com/some/endpoint*"
   ],
   "configurations": [
      {
         "target": "ip",
         "value": "127.0.0.1"
      },
      {
         "target": "ip_range",
         "value": " 2.2.2.0/24"
      }
   ]
}
-s, --json-str
非推奨。 ファイアウォールルールを記述するJSONデータ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ファイアウォール・ルールを更新します。

ibmcloud cis firewall-update FIREWALL_RULE_ID -t access-rules --json '{"mode": "challenge", "notes": "This rule is added because of event X that occurred on date xyz"}'
ibmcloud cis firewall-update FIREWALL_RULE_ID -t ua-rules -d DNS_DOMAIN_ID --json '{"mode": "block", "configuration": {"target": "ua", "value": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4"}}'
ibmcloud cis firewall-update FIREWALL_RULE_ID -t lockdowns -d DNS_DOMAIN_ID --json '{"urls": ["api.mysite.com/some/endpoint*"], "configurations": [{"target": "ip", "value": "127.0.0.1"}, {"target": "ip_range", "value": "2.2.2.0/24"}]}'

ibmcloud cis firewalls

ファイアウォール・ルールをリストします。

ibmcloud cis firewalls (-t, --type Type) [-d, --domain DNS_DOMAIN_ID] [--page PAGE] [--per-page PER_PAGE ] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

-t, --type
作成するファイアウォールルールの種類。 有効な値は access-rules、 ua-rules、 lockdowns。 必須。
  • access-rules: アクセスルールは、Webサイトへのリクエストを許可、検証、またはブロックするための手段です。 アクセス・ルールは、1 つのドメインのみ、または同じサービス・インスタンス内のすべてのドメインに適用できます。
  • ua-rules: クライアントから報告された UserAgent と完全に一致する場合に、アクセス制御を実行します。 特定のクライアントからのトラフィックを管理するように、ルール内でアクセス制御メカニズムを定義できます。 この操作により、サイトへのアクセスをカスタマイズできるようになります。
  • lockdowns: このドメイン内のURLへのアクセスを、許可されたアドレスまたはアドレス範囲のみに制限します。
-d, --domain
DNS ドメイン ID。 ua-rules および lockdowns タイプのルールの場合、これは必須パラメーターです。
--page
ページ番号付けした結果のページ番号。 デフォルト値は 0です。
--per-page
ページあたりの最大アクセス・ルール数。 最小値は です 5。 デフォルト値は20です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ファイアウォール・ルールをリストします。

ibmcloud cis firewalls --type access-rules --instance INSTANCE
ibmcloud cis firewalls --type ua-rules --domain DNS_DOMAIN_ID --instance INSTANCE
ibmcloud cis firewalls --type lockdowns --domain DNS_DOMAIN_ID --instance INSTANCE

ibmcloud cis firewall

ファイアウォール・ルールの詳細を取得します。

ibmcloud cis firewall FIREWALL_RULE_ID (-t, --type Type) [-d, --domain DNS_DOMAIN_ID] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

FIREWALL_RULE_ID
ファイアウォールルールのID。 必須。
-t, --type
作成するファイアウォール・ルールのタイプ。 有効な値は access-rules、 ua-rules、 lockdowns。
  • access-rules: アクセスルールは、Webサイトへのリクエストを許可、検証、またはブロックするための手段です。 アクセス・ルールは、1 つのドメインのみ、または同じサービス・インスタンス内のすべてのドメインに適用できます。
  • ua-rules: クライアントから報告された UserAgent と完全に一致する場合に、アクセス制御を実行します。 特定のクライアントからのトラフィックを管理するように、ルール内でアクセス制御メカニズムを定義できます。 これにより、サイトへのアクセスをカスタマイズできるようになります。
  • lockdowns: このドメイン内のURLへのアクセスを、許可されたアドレスまたはアドレス範囲のみに制限します。
-d, --domain
DNS ドメイン ID。 ua-rules および lockdowns タイプのルールの場合、これは必須パラメーターです。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ファイアウォール・ルールの詳細を取得します。

ibmcloud cis firewall FIREWALL_RULE_ID -t access-rules
ibmcloud cis firewall FIREWALL_RULE_ID -t access-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall FIREWALL_RULE_ID -t ua-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall FIREWALL_RULE_ID -t lockdowns -d DNS_DOMAIN_ID

ibmcloud cis firewall-delete

ファイアウォール・ルールを ID 指定で削除します。

ibmcloud cis firewall-delete FIREWALL_RULE_ID (-t, --type Type) [-d, --domain DNS_DOMAIN_ID] [-i, --instance INSTANCE]

コマンド・オプション

FIREWALL_RULE_ID
ファイアウォールルールのID。 必須。
-t, --type
作成するファイアウォール・ルールのタイプ。 有効な値は access-rules、 ua-rules、 lockdowns。 必須。
  • access-rules: アクセスルールは、Webサイトへのリクエストを許可、検証、またはブロックするための手段です。 アクセス・ルールは、1 つのドメインのみ、または同じサービス・インスタンス内のすべてのドメインに適用できます。
  • ua-rules: クライアントから報告された UserAgent と完全に一致する場合に、アクセス制御を実行します。 特定のクライアントからのトラフィックを管理するように、ルール内でアクセス制御メカニズムを定義できます。 このフィールドを使用すると、サイトへのアクセス権限をカスタマイズできます。
  • lockdowns: このドメイン内のURLへのアクセスを、許可されたアドレスまたはアドレス範囲のみに制限します。
-d, --domain
DNS ドメイン ID。 ua-rules および lockdowns タイプのルールの場合、これは必須パラメーターです。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ファイアウォール・ルールを削除します。

ibmcloud cis firewall-delete FIREWALL_RULE_ID -t access-rules
ibmcloud cis firewall-delete FIREWALL_RULE_ID -t access-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall-delete FIREWALL_RULE_ID -t ua-rules -d DNS_DOMAIN_ID
ibmcloud cis firewall-delete FIREWALL_RULE_ID -t lockdowns -d DNS_DOMAIN_ID

ファイアウォール規則

以下のコマンド firewall-rules を使用して、ファイアウォール・ルールの動作を制御します:

ibmcloud cis firewall-rules

DNS ドメインに対して現在存在するファイアウォール・ルールのリストを取得します。

ibmcloud cis firewall-rules DNS_DOMAIN_ID [--page PAGE] [--per-page PER_PAGE] [-i, --instance INSTANCE] [--output FORMAT

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--page
ページ番号付けした結果のページ番号。 デフォルト値は 1です。
--per-page
ページあたりのファイアウォール・ルールの数。 最小値は 5で、最大値は 100 です。 デフォルト値は25です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン内の既存のファイアーウォールルールをリストアップする DNS_DOMAIN_ID.

ibmcloud cis firewall-rules DNS_DOMAIN_ID

ibmcloud cis firewall-rule

DNSドメインに対する特定のファイアウォールルールを取得します。

ibmcloud cis firewall-rule DNS_DOMAIN_ID FIREWALL_RULE_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
FIREWALL_RULE_ID
ファイアウォールルールのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ファイアウォール・ルールの詳細を確認する FIREWALL_RULE_ID。

ibmcloud cis firewall-rule DNS_DOMAIN_ID FIREWALL_RULE_ID

ibmcloud cis firewall-rule-create

DNSドメイン用のファイアウォールルールを作成します。

ibmcloud cis firewall-rule-create DNS_DOMAIN_ID --expression EXPRESSION --action ACTION [--priority PRIORITY] [--paused on|off] [--products PRODUCTS][--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis firewall-rule-create DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis firewall-rule-create DNS_DOMAIN_ID (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--expression

フィルター演算式。 例えば、ip.src eq 93.184.216.0 です。

--action

実行するルール・アクション。 有効な値は、log、allow、challenge、js_challenge、block、およびbypassです。

--priority

ルールの優先度。 有効な値の範囲は から まで 0 です 2147483647。 この値は、デフォルト値に設定することを意味 0 します。

--description

ルールを簡潔に説明するためのものです。

--paused

ルールが有効か無効かを示します。 有効な値は on および off です。 デフォルト値はoffです。

--products

バイパスされるセキュリティー製品のリスト。 有効な値は zoneLockdown、 uaBlock、 bic、 hot、、 securityLevel、 rateLimit、 および です waf。

--json

ファイアウォール・ルールを記述するために使用されるJSONファイルまたはJSON文字列。

  • JSON データにおける必須フィールドは expression および です action。
    • expression: フィルタ式。 例: ip.src eq 93.184.216.0
    • action: 実行するルールアクション。 有効な値は log、 allow、 challenge、 js_challenge、、 block、 および です bypass。
  • オプション・フィールドは、description、priority、paused、products です。
    • description: ルールについて簡潔に説明する。
    • priority: ルールの優先順位。 有効な値の範囲は から まで 0 です 2147483647。 この値は、デフォルト値に設定することを意味 0 します。
    • paused: ルールが有効か無効かを示します。 有効な値は on と off。 デフォルト値は offです。
    • products: バイパス対象となるセキュリティ製品のリスト。 有効な値は zoneLockdown、 uaBlock、 bic、 hot、 securityLevel、 rateLimit、 です。例 waf : --productszoneLockdown,rateLimit

サンプル JSON データ:

{
   "expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"",
   "action": "allow",
   "priority": 100,
   "paused": false,
   "description": "do not challenge login from office"
}
-s, --json-str
非推奨。 ファイアウォールルールを記述するJSONデータ。
-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン DNS_DOMAIN_ID にファイアウォールルールを作成する。

ibmcloud cis firewall-rule-create DNS_DOMAIN_ID --expression "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"" --action allow --priority 200 --paused off --description "do not challenge login from office"
ibmcloud cis firewall-rule-create DNS_DOMAIN_ID --json '{"expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"", "action": "allow", "priority": 100, "paused": false, "description": "do not challenge login from office"}'

ibmcloud cis firewall-rule-update

DNSドメインの特定のファイアウォールルールを更新します。

ibmcloud cis firewall-rule-update DNS_DOMAIN_ID FIREWALL_RULE_ID [--expression EXPRESSION] [--action ACTION] [--priority PRIORITY] [--paused on|off] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis firewall-rule-update DNS_DOMAIN_ID FIREWALL_RULE_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis firewall-rule-update DNS_DOMAIN_ID FIREWALL_RULE_ID (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

FIREWALL_RULE_ID

ファイアウォールルールのID。 必須。

--expression

フィルター演算式。 例えば、ip.src eq 93.184.216.0 です。

--action

実行するルール・アクション。 有効な値は、log、allow、challenge、js_challenge、block、およびbypassです。

--priority

ルールの優先度。 有効な値の範囲は から まで 0 です 2147483647。 この値は、デフォルト値に設定することを意味 0 します。

--description

ルールを簡潔に説明するためのものです。

--paused

ルールが有効か無効かを示します。 有効な値は on および off です。 デフォルト値はoffです。

--products

バイパスされるセキュリティー製品のリスト。 有効な値は zoneLockdown、 uaBlock、 bic、 hot、、 securityLevel、 rateLimit、 および です waf。

--json

ファイアウォール・ルールを記述するために使用される JSON ファイルまたは JSON 文字列。

  • JSON データにおける必須フィールドは expression、、 および です action。
    • expression: フィルタ式。 例: ip.src eq 93.184.216.0
    • action: 実行するルールアクション。 有効な値は log、 allow、 challenge、 js_challenge、、 block、 および です bypass。
  • オプション・フィールドは、description、priority、paused、products です。
    • description: ルールについて簡潔に説明する。
    • priority: ルールの優先順位。 有効な値の範囲は から まで 0 です 2147483647。 この値は、デフォルト値に設定することを意味 0 します。
    • paused: ルールが有効か無効かを示します。 有効な値は on と off。 デフォルト値は offです。
    • products: バイパス対象となるセキュリティ製品のリスト。 有効な値は zoneLockdown、 uaBlock、 bic、 hot、 securityLevel、 rateLimit、 です。例 waf : --productszoneLockdown,rateLimit

JSONデータで明示的に設定されていないフィールド description、 priority、 paused は、デフォルト値で上書きされます。

サンプル JSON データ:

{
   "expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"",
   "action": "allow",
   "priority": 100,
   "paused": false,
   "description": "do not challenge login from office"
}
-s, --json-str
非推奨。 ファイアウォールルールを記述するJSONデータ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ファイアウォールルールの更新 FIREWALL_RULE_ID.

ibmcloud cis firewall-rule-update DNS_DOMAIN_ID FIREWALL_RULE_ID --expression "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"" --action allow --priority 200 --paused off --description "do not challenge login from office"
ibmcloud cis firewall-rule-update DNS_DOMAIN_ID FIREWALL_RULE_ID --json '{"expression": "ip.src eq 93.184.216.1 and http.request.uri.path ~ \"^.*/wp-login.php$\"", "action": "allow", "priority": 100, "paused": false, "description": "do not challenge login from office"}'

ibmcloud cis firewall-rule-delete

DNS ドメインの特定のファイアウォール・ルールを削除する。

ibmcloud cis firewall-rule-delete DNS_DOMAIN_ID FIREWALL_RULE_ID [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
FIREWALL_RULE_ID
ファイアウォールルールのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ファイアウォールルールの削除 FIREWALL_RULE_ID.

ibmcloud cis firewall-rule-delete DNS_DOMAIN_ID FIREWALL_RULE_ID

ibmcloud cis firewall-rule-validate

firewall-rule 演算式を検証します。

ibmcloud cis firewall-rule-validate DNS_DOMAIN_ID EXPRESSION [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
EXPRESSION
フィルタ式。 例えば、ip.src eq 93.184.216.0 です。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ファイアウォールルール式を検証する。

ibmcloud cis firewall-rule-validate DNS_DOMAIN_ID "ip.src eq 93.184.216.0"

グローバル・ロード・バランサー

以下の glb コマンドを使用して、グローバル・ロード・バランサーを操作します。

ibmcloud cis glb-create

DNS ドメインの下にグローバル・ロードバランサーを作成します。

ibmcloud cis glb-create DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis glb-create DNS_DOMAIN_ID (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--json
グローバル・ロードバランサーを記述するために使用される JSON ファイルまたは JSON 文字列。 必須。
  • JSON データにおける必須フィールドは name、、 fallback_pool 、 です: default_pools
    • name: ロードバランサーに関連付ける DNS ホスト名。
    • fallback_pool: 他のすべてのプールが正常でない状態と検出された場合に使用するプール ID。
    • default_pools: フェイルオーバーの優先順位順に並べられたプール ID のリスト。
  • オプションのフィールドは、description、ttl、region_pools、proxied、enabled、session_affinity、 session_affinity_ttl、steering_policy です。
    • description: ロードバランサーの説明。
    • ttl: このロード・バランサーから返された IP アドレス用の DNS エントリーの存続時間 (TTL)。
    • region_pools: リージョンおよび国コードと、そのリージョンにおけるプール ID の一覧(フェイルオーバー優先順位順)との対応表。
    • proxied: トラフィックを CIS のセキュリティおよびパフォーマンス機能を経由させるかどうかを制御します。
    • enabled: このロードバランサーを有効にするかどうか(デフォルトは有効)。
    • session_affinity セッション中、ユーザーのリクエストが一貫して同じバックエンドサーバーに向けられるようにします。 有効な値は cookie と none。
    • session_affinity_ttl: このロードバランサーのセッションアフィニティ・クッキーが作成されてから有効期限が切れるまでの時間(秒単位)。 有効な値は~の間です [1800, 604800]。 デフォルト値は82800です。
    • steering_policy: の有効な値は off、 geo、 random、 steering_policy です dynamic_latency。
      • off: を使用してください default_pools。
      • geo: を使用してください region_pools/pop_pools。
      • random: プールをランダムに選択します。
      • dynamic_latency: 往復時間(RTT)を使用して、最も近いプールを選択します( default_pools プールのヘルスチェックが必要です)。

サンプル JSON データ:

{
      "name": "www.example.com",
      "fallback_pool": "17b5962d775c646f3f9725cbc7a53df4",
      "default_pools": [
         "17b5962d775c646f3f9725cbc7a53df4",
         "9290f38c5d07c2e2f4df57b1f61d4196"
      ],
      "description": "Example global load balancer.",
      "ttl": 60,
      "region_pools": {
         "WNAM": [
               "de90f38ced07c2e2f4df50b1f61d4194",
               "9290f38c5d07c2e2f4df57b1f61d4196"
         ],
         "ENAM": [
               "00920f38ce07c2e2f4df50b1f61d4194"
         ]
      }
}
-s, --json-str
非推奨。 グローバル・ロード・バランサーを記述する JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン内にグローバル・ロードバランサーを作成します DNS_DOMAIN_ID。

ibmcloud cis glb-create DNS_DOMAIN_ID --json '{"description":"Example global load balancer.","name":"www.example.com","ttl":60,"fallback_pool":"17b5962d775c646f3f9725cbc7a53df4","default_pools":["17b5962d775c646f3f9725cbc7a53df4","9290f38c5d07c2e2f4df57b1f61d4196"],"region_pools":{"WNAM":["de90f38ced07c2e2f4df50b1f61d4194","9290f38c5d07c2e2f4df57b1f61d4196"],"ENAM":["00920f38ce07c2e2f4df50b1f61d4194"]}}'

ibmcloud cis glb-update

DNS ドメイン下のグローバル ロード バランサーを更新する。

ibmcloud cis glb-update DNS_DOMAIN_ID GLB_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis glb-update DNS_DOMAIN_ID GLB_ID (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
GLB_ID
グローバル・ロードバランサーのID。 必須。
--json
グローバル・ロードバランサーを記述するために使用される JSON ファイルまたは JSON 文字列。 必須。
  • JSON データにおける必須フィールドは name、 fallback_pool、、および です: default_pools
    • name: ロードバランサーに関連付ける DNS ホスト名。
    • fallback_pool: 他のすべてのプールが正常でない状態と検出された場合に使用するプール ID。
    • default_pools: フェイルオーバーの優先順位順に並べられたプール ID のリスト。
  • オプションのフィールドは、description、ttl、region_pools、proxied、enabled、session_affinity、 session_affinity_ttl、steering_policy です。
    • description: ロードバランサーの説明。
    • ttl: このロードバランサーによって返される IP アドレスの DNS エントリの有効期間 (TTL)。
    • region_pools: リージョンおよび国コードと、そのリージョンにおけるプール ID の一覧(フェイルオーバー優先順位順)との対応表。
    • proxied: トラフィックを CIS のセキュリティおよびパフォーマンス機能を経由させる必要があるかどうかを制御します。
    • enabled: このロードバランサーを有効にするかどうか(デフォルトは有効)。
    • session_affinity セッション中、ユーザーのリクエストが一貫して同じバックエンドサーバーに向けられるようにします。 有効な値は cookie と none。
    • session_affinity_ttl: このロードバランサーのセッションアフィニティクッキーが作成されてから有効期限が切れるまでの時間(秒単位)。 有効な値は~の間です [1800, 604800]。 デフォルト値は82800です。
    • steering_policy: の有効な値は off、 geo、 random、 steering_policy です dynamic_latency。
      • off: を使用してください default_pools。
      • geo: を使用してください region_pools/pop_pools。
      • random: プールをランダムに選択します。
      • dynamic_latency: 往復時間(RTT)を使用して、最も近いプールを選択します( default_pools プールのヘルスチェックが必要です)。

サンプル JSON データ:

{
      "name": "www.example.com",
      "fallback_pool": "17b5962d775c646f3f9725cbc7a53df4",
      "default_pools": [
         "17b5962d775c646f3f9725cbc7a53df4",
         "9290f38c5d07c2e2f4df57b1f61d4196"
      ],
      "description": "Example global load balancer.",
      "ttl": 60,
      "region_pools": {
         "WNAM": [
               "de90f38ced07c2e2f4df50b1f61d4194",
               "9290f38c5d07c2e2f4df57b1f61d4196"
         ],
         "ENAM": [
               "00920f38ce07c2e2f4df50b1f61d4194"
         ]
      }
}
-s, --json-str
非推奨。 グローバル・ロード・バランサーを記述する JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン DNS_DOMAIN_ID のグローバルロードバランサー GLB_ID を更新する。

ibmcloud cis glb-update DNS_DOMAIN_ID GLB_ID --json '{"description":"Example global load balancer.","name":"www.example.com","ttl":60,"fallback_pool":"17b5962d775c646f3f9725cbc7a53df4","default_pools":["17b5962d775c646f3f9725cbc7a53df4","9290f38c5d07c2e2f4df57b1f61d4196"],"region_pools":{"WNAM":["de90f38ced07c2e2f4df50b1f61d4194","9290f38c5d07c2e2f4df57b1f61d4196"],"ENAM":["00920f38ce07c2e2f4df50b1f61d4194"]}}'

ibmcloud cis glb

DNSドメインの下にあるグローバルロードバランサーを表示します。

ibmcloud cis glb DNS_DOMAIN_ID GLB_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
GLB_ID
グローバル・ロードバランサーのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン GLB_ID 内のグローバル・ロードバランサーを表示します DNS_DOMAIN_ID。

ibmcloud cis glb DNS_DOMAIN_ID GLB_ID

ibmcloud cis glb-delete

DNS ドメイン下のグローバル・ロードバランサーを削除する。

ibmcloud cis glb-delete DNS_DOMAIN_ID GLB_ID [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
GLB_ID
グローバル・ロードバランサーのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ドメイン GLB_ID 内のグローバル・ロードバランサーを削除します DNS_DOMAIN_ID。

ibmcloud cis glb-delete DNS_DOMAIN_ID GLB_ID

ibmcloud cis glbs

そのドメインのすべてのロードバランサーを一覧表示します。

ibmcloud cis glbs DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン.に対応するロードバランサーの一覧 DNS_DOMAIN_ID。

ibmcloud cis glbs DNS_DOMAIN_ID

ibmcloud cis glb-pools

サービス・インスタンスのすべての GLB プールをリストします。

ibmcloud cis glb-pools [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力フォーマットを指定します。 JSON のみがサポートされます。

例

GLBプールをすべてリストアップする。

ibmcloud cis glb-pools

ibmcloud cis glb-pool-create

サービス・インスタンスの GLB プールを作成します。

ibmcloud cis glb-pool-create (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis glb-pool-create (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--json
GLB プールを記述するために使用される JSON ファイルまたは JSON 文字列。 必須。
  • JSON データにおける必須フィールドは name、、 origins 、 です: check_regions
    • name: プールの略称(タグ)。
    • origins: このプール内のオリジンの一覧。
    • check_regions: 地域コードの一覧。
  • オプション・フィールドは、description、minimum_origins、enabled、monitor です。

サンプル JSON データ:

{
   "name": "us-pool",
   "description": "application server pool in US",
   "origins": [
      {
            "name": "us-app-dal01",
            "address": "1.1.1.1",
            "enabled": true,
            "header": {
               "host": ["test.com"]
            }
      },
      {
            "name": "us-app-dal02",
            "address": "2.2.2.2",
            "enabled": true,
            "header": {
               "host": ["example.com"]
            }
      }
   ],
   "minimum_origins": 1,
   "check_regions": [ "WNAM" ],
   "monitor": "f1aba936b94213e5b8dca0c0dbf1f9cc",
   "enabled": true
}
-s, --json-str
非推奨。 GLB プールを説明するために使用される JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

GLBプールを作る。

ibmcloud cis glb-pool-create --json '{"description":"application server pool in US", "name":"us-pool", "enabled":true, "check_regions":["WNAM"], "minimum_origins":1,"monitor":"f1aba936b94213e5b8dca0c0dbf1f9cc", "origins":[{"name":"us-app-dal01","address":"1.1.1.1","enabled":true,"header":{"host":["test.com"]}}, {"name":"us-app-dal02","address":"2.2.2.2","enabled":true,"header":{"host":["example.com"]}}]}'

ibmcloud cis glb-pool

GLB プールの詳細を表示します。

ibmcloud cis glb-pool GLB_POOL_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

GLB_POOL_ID
グローバル・ロードバランサー・プールのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

GLBプールの詳細を表示します GLB_POOL_ID。

ibmcloud cis glb-pool GLB_POOL_ID

ibmcloud cis glb-pool-delete

GLB プールを削除します。

ibmcloud cis glb-pool-delete GLB_POOL_ID [-i, --instance INSTANCE]

コマンド・オプション

GLB_POOL_ID
グローバル・ロードバランサー・プールのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

GLB プールを削除します GLB_POOL_ID。

ibmcloud cis glb-pool-delete GLB_POOL_ID

ibmcloud cis glb-pool-update

GLBプールを更新します。

ibmcloud cis glb-pool-update GLB_POOL_ID [--enable-origin ORIGIN_NAME --enable-origin ORIGIN_NAME ...] [--disable-origin ORIGIN_NAME --disable-origin ORIGIN_NAME ...] [--add-origin ORIGIN_PARAMETER --add-origin ORIGIN_PARAMETER ...] [--remove-origin ORIGIN_NAME --remove-origin ORIGIN_NAME ...]  [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis glb-pool-update GLB_POOL_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis glb-pool-update GLB_POOL_ID (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

GLB_POOL_ID
グローバル・ロードバランサー・プールのID。 必須。
--json
GLB プールを記述するために使用される JSON ファイルまたは JSON 文字列。
  • JSON データにおける必須フィールドは name、、 origins 、 です: check_regions
    • name: プールの略称(タグ)。
    • origins: このプール内のオリジンの一覧。
    • check_regions: 地域コードの一覧。
  • オプション・フィールドは、description、minimum_origins、enabled、monitor です。

サンプル JSON データ:

{
   "name": "us-pool",
   "description": "application server pool in US",
   "origins": [
      {
            "name": "us-app-dal01",
            "address": "1.1.1.1",
            "enabled": true,
            "header": {
               "host": ["example.com"]
            }
      },
      {
            "name": "us-app-dal02",
            "address": "2.2.2.2",
            "enabled": true
      }
   ],
   "minimum_origins": 1,
   "check_regions": [ "WNAM" ],
   "monitor": "f1aba936b94213e5b8dca0c0dbf1f9cc",
   "enabled": true
}
--enable-origin
プール内で起点を有効にします。 値には ORIGIN_NAME または ORIGIN_ADDRESS を指定できます。
--disable-origin
プール内で起点を無効にします。 値には ORIGIN_NAME または ORIGIN_ADDRESS を指定できます。
--add-origin
プールに起点を追加します。 ORIGIN_NAME と ORIGIN_ADDRESS は必須です。 例: --add-originname=us-app-dal01,address=1.1.1.1,enabled=true,weight=0.5,host=example.com
--remove-origin
プールから起点を削除します。 値には ORIGIN_NAME または ORIGIN_ADDRESS を指定できます。
-s, --json-str
非推奨。 GLB プールを説明するために使用される JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

GLB プールを更新する GLB_POOL_ID。

ibmcloud cis glb-pool-update GLB_POOL_ID --json '{"description":"application server pool in US", "name":"us-pool", "enabled":true, "check_regions":["WNAM"], "minimum_origins":1,"monitor":"f1aba936b94213e5b8dca0c0dbf1f9cc", "origins":[{"name":"us-app-dal01","address":"1.1.1.1","enabled":true,"header":{"host":["example.com"]}}, {"name":"us-app-dal02","address":"2.2.2.2","enabled":true}]}'

ibmcloud cis glb-monitors

サービス・インスタンスの GLB モニターをリストします。

ibmcloud cis glb-monitors [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

すべてのGLBモニターをリストアップする。

ibmcloud cis glb-monitors

ibmcloud cis glb-monitor-create

サービス・インスタンスの GLB モニターを作成します。

ibmcloud cis glb-monitor-create (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis glb-monitor-create (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--json

GLB モニターを記述するために使用される JSON ファイルまたは JSON 文字列。 必須。

  • JSON データ内の必須フィールドは type です。
    • type: ヘルスチェックに使用するプロトコル。 有効な値は HTTP、 HTTPS、 TCP である。
  • オプション・フィールドは、description、timeout、retries、interval です。
    • description: 説明。
    • timeout: ヘルスチェックを失敗と判定するまでのタイムアウト(秒単位)。
    • retries: タイムアウトが発生した場合、オリジンを正常でない状態と判定する前に試行する再試行回数。
    • interval: 各ヘルスチェックの間隔。
  • TCP タイプのヘルス・チェックの場合。 追加の必須フィールドは port です。
    • port: ヘルスチェックに使用する TCP ポート。
  • HTTP/HTTPS タイプのヘルス・チェックの場合。 追加のオプション・フィールドは、 port、 expected_body、 expected_codes、 method、 path、 header、 follow_redirects、 allow_insecureです。
    • port: ヘルスチェックに使用する TCP ポート。
    • expected_body: レスポンス本文内で検索する、大文字小文字を区別しない部分文字列。
    • expected_codes: ヘルスチェックで想定される HTTP レスポンスコードまたはコードの範囲。
    • method: ヘルスチェックに使用する HTTP メソッド。
    • path: ヘルスチェックの対象となるエンドポイントのパス。
    • header: ヘルスチェックで送信する HTTP リクエストヘッダー。
    • follow_redirects オリジンからリダイレクトが返された場合は、そのリダイレクトに従ってください。
    • allow_insecure: モニターが HTTPS を使用する場合、証明書の検証を行わないでください。
    • probe_zone: プローブ実行中に指定されたゾーンをエミュレートするには、このモニターを割り当ててください。

サンプル JSON データ:

HTTP/HTTPS の場合:

{
      "description": "Health monitor of web service",
      "type": "https",
      "method": "GET",
      "path": "/health",
      "header": {
         "Host": [
            "example.com"
         ],
         "X-App-ID": [
            "abc123"
         ]
      },
      "timeout": 5,
      "retries": 2,
      "interval": 90,
      "follow_redirects": true,
      "allow_insecure": false,
      "expected_codes": "2xx",
      "expected_body": "alive",
      "probe_zone": "example.com"
}

TCP の場合:

{
      "description": "Health monitor of TCP",
      "type": "tcp",
      "port": 80,
      "timeout": 5,
      "retries": 2,
      "interval": 90
}
-s, --json-str
非推奨。 GLB モニターを説明するために使用される JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

GLBモニターを作る。

ibmcloud cis glb-monitor-create --json '{"type":"https", "description":"Health monitor of web service", "method":"GET", "path":"/health", "header":{"Host":["example.com"],"X-App-ID":["abc123"]}, "port":8080, "timeout":5, "retries":2, "interval":90, "expected_body":"alive", "expected_codes":"2xx", "follow_redirects":true, "allow_insecure":true}'

ibmcloud cis glb-monitor

GLB モニターの詳細を表示します。

ibmcloud cis glb-monitor GLB_MON_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

GLB_MON_ID
グローバル・ロードバランサー・モニターのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

GLB モニターの詳細を表示します GLB_MON_ID。

ibmcloud cis glb-monitor GLB_MON_ID

ibmcloud cis glb-monitor-delete

サービス・インスタンスの GLB モニターを削除します。

ibmcloud cis glb-monitor-delete GLB_MON_ID [-i, --instance INSTANCE]

コマンド・オプション

GLB_MON_ID
グローバル・ロード・バランサー・モニターの ID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

GLBモニターを削除する GLB_MON_ID。

ibmcloud cis glb-monitor-delete GLB_MON_ID

ibmcloud cis glb-monitor-update

サービスインスタンスの GLB モニターを更新します。

ibmcloud cis glb-monitor-update GLB_MON_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis glb-monitor-update GLB_MON_ID (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

GLB_MON_ID

グローバル・ロードバランサー・モニターのID。 必須。

--json

GLB モニターを記述するために使用される JSON ファイルまたは JSON 文字列。 必須。

  • JSON データ内の必須フィールドは type です。
    • type: ヘルスチェックに使用するプロトコル。 有効な値は HTTP、 HTTPS、 TCP である。
  • オプション・フィールドは、description、timeout、retries、interval です。
    • description: 説明。
    • timeout: ヘルスチェックを失敗と判定するまでのタイムアウト(秒単位)。
    • retries: タイムアウトが発生した場合、オリジンを正常でない状態と判定する前に試行する再試行回数。
    • interval: 各ヘルスチェックの間隔。
  • TCP タイプのヘルス・チェックの場合。 追加の必須フィールドは port です。
    • port: ヘルスチェックに使用する TCP ポート。
  • HTTP/HTTPS タイプのヘルス・チェックの場合。 追加のオプション・フィールドは、 port、 expected_body、 expected_codes、 method、 path、 header、 follow_redirects、 allow_insecureです。
    • port: ヘルスチェックに使用する TCP ポート。
    • expected_body: レスポンス本文内で検索する、大文字小文字を区別しない部分文字列。
    • expected_codes: ヘルスチェックで想定される HTTP レスポンスコードまたはコードの範囲。
    • method: ヘルスチェックに使用する HTTP メソッド。
    • path: ヘルスチェックの対象となるエンドポイントのパス。
    • header: ヘルスチェックで送信する HTTP リクエストヘッダー。
    • follow_redirects オリジンからリダイレクトが返された場合は、そのリダイレクトに従ってください。
    • allow_insecure: モニターが HTTPS を使用する場合、証明書の検証を行わないでください。
    • probe_zone: プローブ実行中に指定されたゾーンをエミュレートするには、このモニターを割り当ててください。

サンプル JSON データ:

HTTP/HTTPS の場合:

{
      "description": "Health monitor of web service",
      "type": "https",
      "method": "GET",
      "path": "/health",
      "header": {
         "Host": [
            "example.com"
         ],
         "X-App-ID": [
            "abc123"
         ]
      },
      "timeout": 5,
      "retries": 2,
      "interval": 90,
      "follow_redirects": true,
      "allow_insecure": false,
      "expected_codes": "2xx",
      "expected_body": "alive",
      "probe_zone": "example.com"
}

TCP の場合:

{
      "description": "Health monitor of TCP",
      "type": "tcp",
      "port": 80,
      "timeout": 5,
      "retries": 2,
      "interval": 90
}
-s, --json-str
非推奨。 GLB モニターを説明するために使用される JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

GLB モニターを更新する GLB_MON_ID。

ibmcloud cis glb-monitor-update GLB_MON_ID --json '{"type":"https", "description":"Health monitor of web service", "method":"GET", "path":"/health", "header":{"Host":["example.com"],"X-App-ID":["abc123"]}, "port":8080, "timeout":5, "retries":2, "interval":90, "expected_body":"alive", "expected_codes":"2xx", "follow_redirects":true, "allow_insecure":true}'

ibmcloud cis glb-events

GLB モニターに接続されているオリジンからのステータス変更を一覧表示します。

ibmcloud cis glb-events [-s, --since START_DATE] [-u, --until END_DATE] [--origin-name ORIGIN_NAME] [--pool-name POOL_NAME]
                        [--origin-healthy (true | false)] [--pool-healthy (true | false)]
                        [-i, --instance INSTANCE]  [--output FORMAT]

コマンド・オプション

-s, --since
ISO8601 フォーマットでのデータ期間の開始日。 例: 2018-11-26。
-u, --until
ISO8601 フォーマットでのデータ期間の終了日。 例: 2018-11-28。
--origin-name
フィルター対象の起点の名前。
--pool-name
フィルター対象のプールの名前。
--origin-healthy
true の場合、オリジンのステータスが正常であるイベントをフィルタリングし、false の場合、オリジンのステータスが異常であるイベントをフィルタリングします。 デフォルト値は で true 、有効な値は および true です false。
--pool-healthy
true の場合、プールのステータスが正常であるイベントをフィルタリングし、false の場合、プールのステータスが異常であるイベントをフィルタリングします。 デフォルト値は で true 、有効な値は および true です false。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

glbのイベントを取得します。

ibmcloud cis glb-events --since "2020-05-20" --until "2020-05-22" --origin-name "dal09" --origin-healthy true --instance INSTANCE

即時ログ

以下の instant-log コマンドを使用して、サーバーレス関数のログを即座に作成および取得します。

instant-log-create

ドメインに対してインスタントログのジョブを作成します。 このコマンドは を返します Destination。これは60分間有効です。

cis instant-log-create DNS_DOMAIN_ID [--fields FIELD1,FIELD2,FIELD3|all] [--filter FILTER] [--sample SAMPLE] [-i, --instance INSTANCE] [--output FORMAT] [-h, --help HELP]

ドメインごとにアクティブな Instant Logs セッションは 1 つしか保持できず、セッションの最大時間は 60 分です。

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--fields

返されるフィールドセットを定義します。

  • このフィールドは、空白を含まないカンマ区切りのリストとして指定する必要があり、すべてのフィールドが存在している必要があります。
  • フィールドの指定順序は問題になりません。返答内でのフィールドの順序は指定されません。
  • フィールドは大文字と小文字を区別する。
--filter

特定のイベントをドリルダウンするためのフィルター。 フィルターは、キー、演算子、値の3つの部分で構成される。 サポートされている演算子については 、「フィールド、関数、および式の使用」 を参照してください。

--sample

クライアントによって設定されたレコードのサンプリング率:1 は sample、レコードの 100% を意味します。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

-h, --help

このコマンドに関するヘルプを表示します。

例

ドメイン DNS_DOMAIN_ID のインスタントログを作成する:

ibmcloud cis instant-log-create DNS_DOMAIN_ID --fields all --sample 1

以下にフィルターの例を3つ挙げる:

  • クライアントのIPの国がカナダ以外の場合にフィルタリングする:

"filter": "{\"where\":{\"and\":[{\"key\":\"ClientCountry\",\"operator\":\"neq\",\"value\":\"ca\"}]}}"

  • CIS から返されたステータスコードが200または201の場合にフィルタリングする

"filter": "{\"where\":{\"and\":[{\"key\":\"EdgeResponseStatus\",\"operator\":\"in\",\"value\":\"200,201\"}]}}"

  • リクエストパスに「/static」が含まれ、リクエストのホスト名が「 example.com 」の場合にフィルタリングする

"filter": "{\"where\":{\"and\":[{\"key\":\"ClientRequestPath\",\"operator\":\"contains\",\"value\":\"/static\"}, {\"where\":{\"and\":[{\"key\":\"ClientRequestHost\",\"operator\":\"eq\",\"value\":\"example.com\"}]}}"

instant-log-get

ドメインのインスタント・ログ・ジョブを取得します。

cis instant-log-get DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT] [-h, --help HELP]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。
-h, --help
このコマンドのヘルプ。

例

ドメインの即時ログ取得ジョブを取得 DNS_DOMAIN_ID:

ibmcloud cis instant-log-get DNS_DOMAIN_ID

漏洩した認証情報の確認

Enterprise Plans Only

以下の leaked-credential-checks コマンドを使用して、DNSドメインに対する漏洩認証情報のチェックやカスタム検出を管理します。

ibmcloud cis leaked-credential-checks status-get

DNSドメインの漏洩認証情報の確認状況を取得します。

ibmcloud cis leaked-credential-checks status-get DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis leaked-credential-checks status-get DNS_DOMAIN_ID

ibmcloud cis leaked-credential-checks status-update

DNSドメインに対する認証情報の漏洩チェックを有効または無効にします。

ibmcloud cis leaked-credential-checks status-update DNS_DOMAIN_ID (--enabled true|false) [-i, --instance INSTANCE] [--output FORMAT]

また、ファイルから、あるいは文字列として直接、JSON データを指定することもできます。

ibmcloud cis leaked-credential-checks status-update DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--enabled

このDNSドメインに対して、漏洩した認証情報のチェックが有効になっているかどうかを示します。 有効な値は true および false です。

--json

漏洩した認証情報のチェック設定を記述したJSONファイルまたはJSON文字列。 必須項目は「 enabled 」です。

{
  "enabled": true
}
-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis leaked-credential-checks status-update DNS_DOMAIN_ID --enabled true
ibmcloud cis leaked-credential-checks status-update DNS_DOMAIN_ID --json @status.json --output json

ibmcloud cis leaked-credential-checks detection-list

DNSドメインに対する、漏洩した認証情報の検出項目を一覧表示します。

ibmcloud cis leaked-credential-checks detection-list DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis leaked-credential-checks detection-list DNS_DOMAIN_ID --output json

ibmcloud cis leaked-credential-checks detection-get

リークされた認証情報の検出機能をカスタマイズしましょう。

ibmcloud cis leaked-credential-checks detection-get DNS_DOMAIN_ID DETECTION_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
DETECTION_ID
カスタム漏洩認証情報検出のID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis leaked-credential-checks detection-get DNS_DOMAIN_ID DETECTION_ID

ibmcloud cis leaked-credential-checks detection-create

カスタム漏洩認証情報検出機能を作成します。

ibmcloud cis leaked-credential-checks detection-create DNS_DOMAIN_ID (--username EXPRESSION) (--password EXPRESSION) [-i, --instance INSTANCE] [--output FORMAT]

また、ファイルから、あるいは文字列として直接、JSON データを指定することもできます。

ibmcloud cis leaked-credential-checks detection-create DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--username

リクエスト内のユーザー名を特定するためのルールセット式。 --json を使用しない場合に必要です。

--password

リクエスト内のパスワードを特定するためのルールセット式。 --json を使用しない場合に必要です。

--json

カスタム検出を記述したJSONファイルまたはJSON文字列。 必須入力項目は、 username および password です。

{
  "username": "lookup_json_string(http.request.body.raw, \"username\")",
  "password": "lookup_json_string(http.request.body.raw, \"password\")"
}
-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis leaked-credential-checks detection-create DNS_DOMAIN_ID --username 'lookup_json_string(http.request.body.raw, "username")' --password 'lookup_json_string(http.request.body.raw, "password")'
ibmcloud cis leaked-credential-checks detection-create DNS_DOMAIN_ID --json @detection.json --output json

ibmcloud cis leaked-credential-checks detection-update

カスタム漏洩認証情報の検出機能を更新します。 --username または --password のいずれか少なくとも1つを指定するか、JSON形式の入力データを指定してください。

ibmcloud cis leaked-credential-checks detection-update DNS_DOMAIN_ID DETECTION_ID [--username EXPRESSION] [--password EXPRESSION] [-i, --instance INSTANCE] [--output FORMAT]

また、ファイルから、あるいは文字列として直接、JSON データを指定することもできます。

ibmcloud cis leaked-credential-checks detection-update DNS_DOMAIN_ID DETECTION_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
DETECTION_ID
カスタム漏洩認証情報検出のID。 必須。
--username
リクエスト内のユーザー名を特定するためのルールセット式。
--password
リクエスト内のパスワードを特定するためのルールセット式。
--json
カスタム検出を記述したJSONファイルまたはJSON文字列。 オプションのフィールドは「 username 」と「 password 」です。少なくとも1つは指定してください。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis leaked-credential-checks detection-update DNS_DOMAIN_ID DETECTION_ID --username 'lookup_json_string(http.request.body.raw, "email")'
ibmcloud cis leaked-credential-checks detection-update DNS_DOMAIN_ID DETECTION_ID --json @detection.json --output json

ibmcloud cis leaked-credential-checks detection-delete

カスタム漏洩認証情報検出を削除する。

ibmcloud cis leaked-credential-checks detection-delete DNS_DOMAIN_ID DETECTION_ID [-f, --force] [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
DETECTION_ID
カスタム漏洩認証情報検出のID。 必須。
-f, --force
確認のメッセージを表示せずに、検出結果を削除します。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ibmcloud cis leaked-credential-checks detection-delete DNS_DOMAIN_ID DETECTION_ID --force

Logpull

ibmcloud cis log-lookup-rayid

Enterprise Plans Only

特定の Ray ID に関連付けられているログイベントを取得します。 このコマンドを使用する前に、対象のDNSドメインでログの保持が有効になっている必要があります。

Ray ID に、 -XXX のようなデータセンターのサフィックスが含まれている場合は、コマンドを実行する前にそのサフィックスを削除してください。

ibmcloud cis log-lookup-rayid DNS_DOMAIN_ID RAY_ID [--fields FIELDS] [--timestamps FORMAT] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
RAY_ID
リクエストの Ray ID。 必須。
--fields
返すログフィールドのリスト(大文字と小文字を区別し、カンマ区切り)。
--timestamps
タイムスタンプフィールドの形式。 有効な値は unix、 unixnano、 rfc3339。 デフォルト値は unixです。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis log-lookup-rayid DNS_DOMAIN_ID RAY_ID
ibmcloud cis log-lookup-rayid DNS_DOMAIN_ID RAY_ID --fields RayID,ClientIP,EdgeResponseStatus --timestamps rfc3339 --output json

ibmcloud cis logpull

以下の logpull コマンドを使用して、Logpull サービスを扱います。

ibmcloud cis logpull DNS_DOMAIN_ID --available-fields [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--available-fields
使用可能なすべてのフィールドのリスト。
--ray-id
特定のレイ ID でログを検索します。
--fields
返されるフィールドセットを定義します。 このフィールドは、スペースを含まないカンマ区切りのリストとして指定する必要があり、すべてのフィールドが存在している必要があります。 フィールドの指定順序は問題になりません。返答内でのフィールドの順序は指定されません。 フィールドでは大/小文字が区別されることに注意してください。
--start
要求された時間フレームの開始時点 (その時刻を含む)。 これは UNIX タイム・スタンプ (秒またはナノ秒単位) または RFC 3339 に準拠する絶対タイム・スタンプにできます。 現在、指定できる過去の日付は7日以内に限られています。 デフォルトは 65 分前です。
--end
要求された時間フレームの終了時点 (その時刻を含まない)。 この値は、Unix タイムスタンプ(秒またはナノ秒単位)か、RFC 3339 に準拠した絶対タイムスタンプのいずれかです。 end は少なくとも現在の 5 分前であり、start より後である必要があります。 と start の差は、 1h を超えてはならない end。 デフォルトは5分早めになっています。
--count
検索するログの数。 デフォルト値は -1です。
--sample
サンプリングのパーセント。 サンプルが指定された場合、一致するレコードのサンプルが返されます。 もし~ sample=0.1 なら、レコードの10%が返されます。 サンプリングはランダムに行われます。同じ呼び出しを繰り返しても、返されるレコードが異なるだけでなく、返されるレコードの数にもわずかなばらつきが生じる可能性があります。 カウントも指定されている場合、カウントはサンプリングされたレコードではなく、返されるレコードの数に適用されます。 したがって、および sample=0.05 を使用すると count=7、利用可能なレコードが合計 100 件ある場合、約 5 件のレコードが返されます。 レコードが 1000 件ある場合、7 件が返されます。 レコードが 10,000 件ある場合、7 件が返されます。 デフォルト値は 1です。
--timestamps
応答タイム・スタンプが返される際の形式を設定します。 有効な値は、unix、unixnano、およびrfc3339です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis logpull DNS_DOMAIN_ID --available-fields
ibmcloud cis logpull DNS_DOMAIN_ID --ray-id 59348abde87afe50 --all-fields --timestamps rfc3339 --output json
ibmcloud cis logpull DNS_DOMAIN_ID --start 2020-05-18T12:14:58Z --end 2020-05-18T13:14:58Z --fields ClientIP,EdgeServerIP,ClientRequestHost --count 10 --sample 1 --timestamps rfc3339 --output json

Logpush

Enterprise Plans Only

ibmcloud cis logpush-job-create

Enterprise Plans Only

ドメインに対して新しいlogpushジョブを作成する。

ibmcloud cis logpush-job-create DNS_DOMAIN_ID --destination DESTINATION_URL --name NAME [--enable true|false] [--fields FIELDS | all] [--timestamps format][--dataset DATASET] [--frequency FREQUENCY] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--destination
データのプッシュ先を指定する。 サポートされる宛先の詳細については、 Logpushジョブの管理を 参照してください。
  • Cloud Object Storage のパスに関する構文: cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>&ibm_api_key=<API_KEY>' 次に例を示します。 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX' ログを日ごとのサブフォルダに分割するには、バケットパス {DATE} に特別な文字列を使用してください。 これは、例えば20190423のような YYYYMMDD 形式の日付に置き換えられます。 必要に応じてサブフォルダが作成されます。例: 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX'
--name
ジョブ名。 必須。
--enable
ジョブを有効にします。 デフォルトでは、ジョブは無効に設定されています。
--fields
ログ・ファイルに含めるログ・フィールドのリストを定義します。 複数のフィールドはコンマで区切ることができます。利用可能なログフィールドの包括的なリストを取得 [ibmcloud cis logpush-available-fields DNS_DOMAIN_ID] するには command を使用するか、ログファイルに利用可能なすべてのフィールドを含める all には を使用してください。 フィールドでは大/小文字が区別されることに注意してください。
--timestamps
応答タイム・スタンプが返される際の形式を設定します。 有効な値は、unix、unixnano、およびrfc3339です。
--dataset
受信したいログのカテゴリ。 この値は、ジョブが作成された後は変更できません。 有効な値は http_requests, range_events, firewall_events, dns_logs です。デフォルト値は http_requests です。
--frequency
CIS がユーザーの宛先にログのバッチを送信する頻度。 頻度を高に設定すると、ログはより多くの小さなファイルに分割されて送信されます。 頻度を低に設定すると、ログは少量ずつ、より大きなファイルとして送信されます。 有効な値は high、 です low。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン DNS_DOMAIN_ID のlogpushジョブを作成する。

ibmcloud cis logpush-job-create DNS_DOMAIN_ID --destination cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX --name logpushcreate --enable true --fields all --timestamps rfc3339 --dataset http_requests --frequency low --output json

ibmcloud cis logpush-job-update

Enterprise Plans Only

ドメインのlogpushジョブを更新する。

ibmcloud cis logpush-job-update DNS_DOMAIN_ID [--destination DESTINATION_URL] [--enable true|false] [--fields FIELDS | all] [--timestamps format] [--dataset DATASET] [--jobid JOB_ID] [--frequency FREQUENCY] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--destination
データのプッシュ先を指定する。 サポートされる宛先の詳細については、 Logpushジョブの管理を 参照してください。 Cloud Object Storage のパスに関する構文: cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>ibm_api_key=<API_KEY> 次に例を示します。 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX' ログを日付別のサブフォルダーに分けるには、バケット・パスで特殊ストリング {DATE} を使用します。 この部分は、例えば20190423 YYYYMMDD のような形式の日付に置き換えてください。 必要に応じてサブフォルダが作成されます。例: 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX'
--enable
ジョブを有効にします。 デフォルトでは、ジョブは無効に設定されています。
--fields
ログ・ファイルに含めるログ・フィールドのリストを定義します。 複数のフィールドはコンマで区切ることができます。利用可能なログフィールドの包括的なリストを取得 ibmcloud cis logpush-available-fields DNS_DOMAIN_ID するには command を使用するか、ログファイルに利用可能なすべてのフィールドを含める all には を使用してください。 フィールドでは大/小文字が区別されることに注意してください。
--timestamps
応答タイム・スタンプが返される際の形式を設定します。 有効な値は unix、 unixnano、 です rfc3339。
--dataset
受信したいログのカテゴリ。 この値は、ジョブが作成された後は変更できません。 有効な値は http_requests, range_events, firewall_events,dns_logs です。デフォルト値は http_requests です。
--jobid
JOB_IDはlogpushジョブのIDである。
--frequency
CIS がユーザーの宛先にログのバッチを送信する頻度。 頻度を高に設定すると、ログはより多くの小さなファイルに分割されて送信されます。 頻度を低に設定すると、ログは少量ずつ、より大きなファイルとして送信されます。 有効な値は high および low です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

DNS_DOMAIN_ID ドメインの range_events logpush ジョブを更新する。

ibmcloud cis logpush-job-update DNS_DOMAIN_ID --destination cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX --enable true --fields all --timestamps rfc3339 --dataset range_events --frequency high --output json

ibmcloud cis logpush-jobs

Enterprise Plans Only

ドメインのすべてのlogpushジョブを取得する。

ibmcloud cis logpush-jobs DNS_DOMAIN_ID  [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
-output
出力形式。 現在、 が唯一サポートされている値です json。

例

DNS_DOMAIN_ID ドメインのすべての logpush ジョブを取得します。

ibmcloud cis logpush-jobs DNS_DOMAIN_ID --output json

ibmcloud cis logpush-job

Enterprise Plans Only

ドメインのログプッシュジョブの詳細を確認します。

ibmcloud cis logpush-job DNS_DOMAIN_ID [--dataset DATASET] [--jobid JOB_ID] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--dataset
受信したいログのカテゴリ。 この値は、ジョブが作成された後は変更できません。 有効な値は http_requests, range_events, firewall_events,dns_logs です。デフォルト値は http_requests です。
--jobid
JOB_IDはlogpushジョブのIDである。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

http_requests logpushジョブの詳細を取得する。

ibmcloud cis logpush-job DNS_DOMAIN_ID --dataset http_requests --output json

ibmcloud cis logpush-job-delete

Enterprise Plans Only

ドメインのlogpushジョブを削除します。

ibmcloud cis logpush-job-delete DNS_DOMAIN_ID [--dataset DATASET] [--jobid JOB_ID] [-f, --force] [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--dataset
受信したいログのカテゴリ。 この値は、ジョブが作成された後は変更できません。 有効な値は http_requests, range_events, firewall_events,dns_logs です。デフォルト値は http_requests です。
--jobid
JOB_IDはlogpushジョブのIDである。
-f, --force
確認のメッセージを表示せずに、logpushジョブを削除します。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

DNS_DOMAIN_ID ドメインの http_requests logpush ジョブを削除する。

ibmcloud cis logpush-job-delete DNS_DOMAIN_ID --dataset http_requests --force

ibmcloud cis logpush-available-fields

Enterprise Plans Only

データ・セットのすべての使用可能なフィールドを取得します。

ibmcloud cis logpush-available-fields DNS_DOMAIN_ID [--dataset DATASET] [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--dataset
受信したいログのカテゴリ。 この値は、ジョブが作成された後は変更できません。 有効な値は http_requests, range_events, firewall_events,dns_logs です。デフォルト値は http_requests です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

http_requests ログの使用可能なすべてのフィールドを取得します。

ibmcloud cis logpush-available-fields DNS_DOMAIN_ID --dataset http_requests

ログ保持期間

Enterprise Plans Only

ibmcloud cis log-retention

ドメインのログ保存期間設定を取得します。

ibmcloud cis log-retention DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのログ保持設定を取得する DNS_DOMAIN_ID。

ibmcloud cis log-retention DNS_DOMAIN_ID --output json

ibmcloud cis ログ保持更新

ドメインのログ保存期間設定を更新します。

ibmcloud cis log-retention-update DNS_DOMAIN_ID (--flag on|off) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--flag
ログの保存機能を有効にするか無効にするか。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのログ保持を有効にする DNS_DOMAIN_ID。

ibmcloud cis log-retention-update DNS_DOMAIN_ID --flag on --output json

管理リスト

以下の managed-lists コマンドを使用して管理リストを操作する。

cis managed-lists

インスタンス内の管理対象リストを一覧表示します。

cis managed-lists [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ibmcloud cis managed-lists --output json --instance INSTANCE

メトリック

以下の metrics コマンドを使用して、メトリックを扱います。

ibmcloud cis firewall-event-analytics

ファイアウォール・イベントの完全ログを取得します。

ibmcloud cis firewall-event-analytics DNS_DOMAIN_ID [--dataset DATA_SET] [--filter FILTER] [--order FILTER_ORDER] [--limit LIMIT_NUMBER] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--dataset

要求されたデータ・セット。 デフォルト値は firewallEventsAdaptiveGroupsです。

次の表で、プランに含まれるデータ・セットと、照会可能な履歴データの範囲を確認してください。

プランに含まれるデータセット
データ・セット トライアル / スタンダード / スタンダード-ネクスト エンタープライズ / セキュリティー / GLB
firewallEventsAdaptiveGroups 30 日間 30 日間
firewallEventsAdaptive 30 日間 30 日間
--filter
イベントをフィルターします。 デフォルト値は直近 6 時間のデータです。

次の演算子はすべてのフィルター・オプションでサポートされています。

フィルタオプションでサポートされている演算子
演算子 比較
gt 次より大きい
リトアニア より小さい
GEQ 以上
leq 以下
ネク 等しくない
in in
  • firewallEventsAdaptiveGroups filter options.
    • datetime
    • datetimeFifteenMinutes
    • datetimeHour
    • datetimeFiveMinutes
    • datetimeMinute
    • matchIndex
    • sampleInterval
  • The following filter options support like and notlike operators.
    • action
    • clientASNDescription
    • clientAsn
    • clientCountryName
    • clientIP
    • clientRefererHost
    • clientRefererPath
    • clientRefererQuery
    • clientRefererScheme
    • clientRequestHTTPHost
    • clientRequestHTTPMethodName
    • clientRequestHTTPProtocol
    • clientRequestPath
    • clientRequestQuery
    • clientRequestScheme
    • edgeColoName
    • edgeResponseStatus
    • kind
    • originResponseStatus
    • originatorRayName
    • rayName
    • ref
    • ruleId
    • source
    • userAgent
--order

出力順。 (デフォルト値は datetime_ASC)

以下のリストは、対応するデータ・セットの使用可能な順序オプションであり、すべての順序オプションは ASC および DESC アクションをサポートします。 これらのフィルター・オプションとアクションを _ で組み合わせてください。

例:datetime 順に昇順で並べ datetime_ASC 替えます。

  • firewallEventsAdaptiveGroups 順序オプション。
    • datetime
    • datetimeFifteenMinutes
    • datetimeHour
    • datetimeFiveMinutes
    • datetimeMinute
    • action
    • avg_sampleInterval
    • clientASNDescription
    • clientAsn
    • clientCountryName
    • clientIPClass
    • clientIP
    • clientRefererHost
    • clientRefererPath
    • clientRefererQuery
    • clientRefererScheme
    • clientRequestHTTPHost
    • clientRequestHTTPMethodName
    • clientRequestHTTPProtocol
    • clientRequestPath
    • clientRequestQuery
    • clientRequestScheme
    • count
    • edgeColoName
    • edgeResponseStatus
    • kind
    • matchIndex
    • originResponseStatus
    • originatorRayName
    • rayName
    • ref
    • ruleId
    • sampleInterval
    • source
    • userAgent
    • visibility
--limit

返すイベントの数。(最小: 1、最大: 10000、デフォルト: 10000 )

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのファイアウォールイベント分析を取得する DNS_DOMAIN_ID。

ibmcloud cis firewall-event-analytics DNS_DOMAIN_ID --order datetime_ASC --filter "datetime_geq:2020-06-28T00:00:00Z" --filter "datetime_leq:2020-06-29T00:00:00Z" --output json

ibmcloud cis http-request-analytics

http 要求イベントの完全ログを取得します。

ibmcloud cis http-request-analytics DNS_DOMAIN_ID [--dataset DATA_SET] [--filter FILTER] [--order FILTER_ORDER] [--limit LIMIT_NUMBER] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--dataset

要求されたデータ・セット。 デフォルト値は httpRequests1dGroupsです。 次の表で、プランに含まれるデータ・セットと、照会可能な履歴データの範囲を確認してください。

プランに含まれるデータセットを特定する
データ・セット トライアル / スタンダード / スタンダードネクスト エンタープライズ / セキュリティー / GLB
httpRequests1dGroups 365 日間 365 日間
httpRequests1hGroups 30 日間 90 日間
httpRequests1mGroups 3 日 7 日間
--filter

イベントをフィルターします。 デフォルト値は直近 7 日間のデータです。 次の演算子はすべてのフィルター・オプションでサポートされています。

フィルタオプションでサポートされている演算子
演算子 比較
gt 次より大きい
リトアニア より小さい
GEQ 以上
leq 以下
ネク 等しくない
in in
  • httpRequests1dGroups および httpRequests1hGroups フィルター・オプション。

    • date
  • httpRequests1mGroups フィルター・オプション。

    • datetime
    • datetimeFifteenMinutes
    • datetimeHour
    • datetimeDay
--order

出力順。 (デフォルト値は datetime_ASC)

以下のリストは、対応するデータ・セットの使用可能な順序オプションであり、すべての順序オプションは ASC および DESC アクションをサポートします。 これらの順序オプションとアクションを _ で組み合わせてください。

例:日付の昇順で並べ date_ASC 替える。

  • 日常の http データ・セットに共通の順序オプション。
    • orderByParams
    • date
    • sum_bytes
    • sum_cachedBytes
    • sum_cachedRequests
    • sum_requests
  • httpRequests1dGroups 順序オプション。
    • avg_bytes
    • sum_encryptedBytes
    • sum_encryptedRequests
    • sum_pageViews
    • sum_threats
    • uniq_uniques
  • httpRequests1hGroups 順序オプション。
    • avg_bytes
    • sum_encryptedBytes
    • sum_encryptedRequests
    • sum_pageViews
    • sum_threats
    • uniq_uniques
    • datetime
  • httpRequests1mGroups 順序オプション。
    • avg_bytes
    • sum_encryptedBytes
    • sum_encryptedRequests
    • sum_pageViews
    • sum_threats
    • uniq_uniques
    • datetime
    • datetimeFifteenMinutes
    • datetimeHour
    • datetimeFifteenMinutes
    • datetimeHour
    • datetimeDay
--limit

返すイベントの数。(最小: 1、最大: 10000、デフォルト: 10000 )

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのHTTPリクエスト分析を取得する DNS_DOMAIN_ID。

ibmcloud cis http-request-analytics DNS_DOMAIN_ID --order date_ASC --dataset httpRequests1dGroups --limit 500 --filter "date_geq:2020-06-28" --filter "date_leq:2020-06-29" --output json

ibmcloud cis web-analytics(非推奨)

ウェブ解析は2020年11月2日に廃止されます。 代わりに ibmcloud cis http-request-analytics を使用してください。 DNS ドメインのアナリティクスを取得します。

ibmcloud cis web-analytics DNS_DOMAIN_ID [--recent DURATION] [-t, --table requests | bandwidth | uniques | threats | status_code] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--recent
要求された時間フレームの開始時点。 有効な値は ( 6h 6時間前)、 12h、 1d (1日前)、 1w (1週間前)、 ( 1m 1ヶ月前)、 2m、 です 3m。デフォルト値は です 1w。
-t, --table
出力テーブル。 有効な値は requests、 bandwidth、 uniques、 threats 、、 です status_code。 このフィールドが設定されていない場合は、すべてのテーブルを出力する。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン.のウェブ分析を取得する DNS_DOMAIN_ID。

ibmcloud cis web-analytics DNS_DOMAIN_ID --recent 1d -t requests

ibmcloud cis dns-analytics

ドメインの DNS アナリティクスを取得します。

ibmcloud cis dns-analytics DNS_DOMAIN_ID DIMENSION [-s, --since TIME] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
DIMENSION
問い合わせられたディメンション。 有効な値は queries-by-response-code, queries-by-type, queries-by-name。必須。
-s, --since
現在からどのくらい前か。 有効な値は ( 6h 6時間前)、 12h、 1d (1日前)、 1w (1週間前) です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインの DNS 分析を取得する DNS_DOMAIN_ID。

ibmcloud cis dns-analytics DNS_DOMAIN_ID queries-by-response-code -s 6h --output json

ibmcloud cis ratelimit-analytics

DNS ドメインのレート制限アナリティクスを取得します。

ibmcloud cis ratelimit-analytics DNS_DOMAIN_ID [--recent DURATION] [--time-delta SECONDS] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--recent
要求された時間フレームの開始時点。 有効な値は ( 6h 6時間前)、 12h、 1d (1日前)、 1w (1週間前)、 ( 1m 1ヶ月前)、 2m、 です 3m。デフォルト値は です 1w。
--time-delta
各アナリティクスのレコードの時間間隔 (秒単位)。 有効な値は 60, 3600, 86400, 2592000 です。デフォルト値は 3600 です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのレート制限分析を取得する DNS_DOMAIN_ID。

ibmcloud cis ratelimit-analytics DNS_DOMAIN_ID --recent 6h --time-delta 3600 --output json

MTLS の有効化

ibmcloud cis access-enable

Enterprise Plans Only

サービスインスタンスで相互 TLS を有効にする。

ibmcloud cis access-enable [-i, --instance INSTANCE]

コマンド・オプション

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

相互 TLS を有効にする。

ibmcloud cis access-enable

起点証明書

ibmcloud cis origin-certificates

DNS ドメインのすべてのオリジン証明書を一覧表示します。

ibmcloud cis origin-certificates DNS_DOMAIN_ID [--instance INSTANCE_NAME] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン.のすべてのオリジン証明書を一覧表示します DNS_DOMAIN_ID。

ibmcloud cis origin-certificates DNS_DOMAIN_ID --output json

ibmcloud cis origin-certificate-create

CIS 署名証明書を作成します。

ibmcloud cis origin-certificate-create DNS_DOMAIN_ID [--request-type REQUEST_TYPE] [--hostnames HOST_NAME1] [--hostnames HOST_NAME2] [--requested-validity DAYS] [--csr CSR] [--instance INSTANCE_NAME] [--output FORMAT]
ibmcloud cis origin-certificate-create DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis origin-certificate-create DNS_DOMAIN_ID --json-str JSON_STR [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis origin-certificate-create DNS_DOMAIN_ID --json-file JSON_FILE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--request-type REQUEST_TYPE

証明書に記載する署名タイプ。 有効な値は origin-rsa および origin-ecc です。

--hostnames HOSTNAME

証明書にバインドされるホスト名またはワイルドカード名。

--requested-validity DAYS

証明書の有効期間(日数)。 デフォルト値は 5475です。

--csr CSR

証明書署名要求 (CSR)。 このフィールドが設定されていない場合、 CIS。

--json value*

オリジン証明書を記述するために使用される JSON ファイルまたは JSON 文字列。

  • JSON データ内の必須フィールドは request_type、hostnames です。
    • request_type 証明書に記載する署名タイプ。 有効な値は origin-rsa、 です origin-ecc。
    • hostnames: 証明書に紐付けられているホスト名またはワイルドカード名の配列。
  • オプション・フィールドは、requested_validity、csr です。
    • requested_validity: 証明書の有効期間(日数)。 有効な値は 0、 7、 30、 90、、 365、 730、 1095、 です 5475。
    • csr: 証明書署名要求(CSR)。 このフィールドが設定されていない場合、 CIS。

サンプル JSON データ:

{
   "request_type": "origin-rsa",
   "hostnames": [
      "*.example.com",
      "example.com",
],
   "requested_validity": 5475,
   "csr": "your_csr"
}
-s, --json-str
非推奨。 オリジン証明書を記述するJSONデータ。
-j, --json-file

非推奨。 ファイルは入力 JSON データを含みます。

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン用の CIS 署名付き証明書を作成する DNS_DOMAIN_ID。

ibmcloud cis origin-certificate-create DNS_DOMAIN_ID --request-type origin-rsa --hostnames "*.example.com" --hostnames "example.com" --requested-validity 5475 --csr your_csr --output json
ibmcloud cis origin-certificate-create DNS_DOMAIN_ID --json '{"hostnames":["example.com","*.example.com"], "requested_validity":5475,"request_type": "origin-rsa","csr":"-----BEGIN CERTIFICATE REQUEST-----\nMIICxzCCAa8CAQAwSDELMAkGA1UEBhMCVVMxFjAUBgNVBAgTDVNhbiBGcmFuY2lz\nY28xCzAJBgNVBAcTAkNBMRQwEgYDVQQDEwtleGFtcGxlLm5ldDCCASIwDQYJKoZI\nhvcNAQEBBQADggEPADCCAQoCggEBALxejtu4b+jPdFeFi6OUsye8TYJQBm3WfCvL\nHu5EvijMO/4Z2TImwASbwUF7Ir8OLgH+mGlQZeqyNvGoSOMEaZVXcYfpR1hlVak8\n4GGVr+04IGfOCqaBokaBFIwzclGZbzKmLGwIQioNxGfqFm6RGYGA3be2Je2iseBc\nN8GV1wYmvYE0RR+yWweJCTJ157exyRzu7sVxaEW9F87zBQLyOnwXc64rflXslRqi\ng7F7w5IaQYOl8yvmk/jEPCAha7fkiUfEpj4N12+oPRiMvleJF98chxjD4MH39c5I\nuOslULhrWunfh7GB1jwWNA9y44H0snrf+xvoy2TcHmxvma9Eln8CAwEAAaA6MDgG\nCSqGSIb3DQEJDjErMCkwJwYDVR0RBCAwHoILZXhhbXBsZS5uZXSCD3d3dy5leGFt\ncGxlLm5ldDANBgkqhkiG9w0BAQsFAAOCAQEAcBaX6dOnI8ncARrI9ZSF2AJX+8mx\npTHY2+Y2C0VvrVDGMtbBRH8R9yMbqWtlxeeNGf//LeMkSKSFa4kbpdx226lfui8/\nauRDBTJGx2R1ccUxmLZXx4my0W5iIMxunu+kez+BDlu7bTT2io0uXMRHue4i6quH\nyc5ibxvbJMjR7dqbcanVE10/34oprzXQsJ/VmSuZNXtjbtSKDlmcpw6To/eeAJ+J\nhXykcUihvHyG4A1m2R6qpANBjnA0pHexfwM/SgfzvpbvUg0T1ubmer8BgTwCKIWs\ndcWYTthM51JIqRBfNqy4QcBnX+GY05yltEEswQI55wdiS3CjTTA67sdbcQ==\n-----END CERTIFICATE REQUEST-----"}' --output json

ibmcloud cis origin-certificate

原産地証明書の詳細を取得します。

ibmcloud cis origin-certificate DNS_DOMAIN_ID CERT_ID [--instance INSTANCE_NAME] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
CERT_ID
原産地証明書のID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

オリジン証明書の詳細を確認する CERT_ID。

ibmcloud cis origin-certificate DNS_DOMAIN_ID CERT_ID --output json

ibmcloud cis origin-certificate-delete

起点証明書を削除します。

ibmcloud cis origin-certificate-delete DNS_DOMAIN_ID CERT_ID [--instance INSTANCE_NAME]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
CERT_ID
Origin CertificateのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

オリジン証明書を削除します CERT_ID。

ibmcloud cis origin-certificate-delete DNS_DOMAIN_ID CERT_ID

概要

ドメインの概要情報を表示します。

ibmcloud cis overview

ドメインの概要情報を表示します。

ibmcloud cis overview DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインの概要情報を表示します DNS_DOMAIN_ID。

ibmcloud cis overview DNS_DOMAIN_ID

ページ・ルール

以下の pagerule コマンドを使用して、ページ・ルールを扱います。

ibmcloud cis page-rule-create

DNS ドメインのページ・ルールを作成します。

ibmcloud cis page-rule-create DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis page-rule-create DNS_DOMAIN_ID (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--json
ページルールを記述するために使用される JSON ファイルまたは JSON 文字列。 必須。
  • JSON データにおける必須フィールドは、targets、actions です:
    • targets: リクエストに対して評価を行う対象の URL パターン。
    • actions: このルールの対象がリクエストと一致した場合に実行される一連のアクション。 以下のアクションが使用可能です。
      • disable_security
      • always_use_https
      • ssl
      • browser_cache_ttl
      • security_level
      • cache_level
      • edge_cache_ttl
      • bypass_cache_on_cookie
      • browser_check
      • server_side_exclude
      • email_obfuscation
      • automatic_https_rewrites
      • opportunistic_encryption
      • ip_geolocation
      • explicit_cache_control
      • cache_deception_armor
      • waf
      • forwarding_url
      • 非推奨。 image_load_optimization.
      • image_size_optimization
      • script_load_optimization
      • host_header_override
      • resolve_override
      • 一部の機能はEnterpriseプランに限定されています:
        • cache_on_cookie
        • disable_apps
        • disable_performance
        • minify
        • origin_error_page_pass_thru
        • response_buffering
        • true_client_ip_header
        • sort_query_string_for_cache
        • respect_strong_etag
  • オプションのフィールドは priority および です: status
    • priority: あるページルールが別のルールよりも優先される度合いを示す数値。 デフォルト値は1です。
    • status: ページルールのステータス。 有効な値は active および ( disabled デフォルト)です。

サンプル JSON データ:

   {
   "targets": [
      {
            "target": "url",
            "constraint": {
               "operator": "matches",
               "value": "*example.com/images/*"
            }
      }
   ],
   "actions": [
      {
            "id": "ssl",
            "value": "flexible"
      },
      {
            "id": "browser_cache_ttl",
            "value": 14400
      },
      {
            "id": "security_level",
            "value": "medium"
      },
      {
            "id": "cache_level",
            "value": "basic"
      },
      {
            "id": "edge_cache_ttl",
            "value": 7200
      },
      {
            "id": "bypass_cache_on_cookie",
            "value": "wp-.*|wordpress.*|comment_.*"
      }
   ]
}
-s, --json-str
非推奨。 ページ・ルールを記述する JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン.に対するページルールを作成します DNS_DOMAIN_ID。

ibmcloud cis page-rule-create DNS_DOMAIN_ID --json '{"targets":[{"target":"url", "constraint":{"operator": "matches", "value":"*example.com/images/*"}}], "actions":[{"id":"always_online", "value":"on"}], "priority":1, "status": "active"}' --output json

ibmcloud cis page-rule-update

DNS ドメインのページ・ルールを更新します。

ibmcloud cis page-rule-update DNS_DOMAIN_ID PAGE_RULE_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis page-rule-update DNS_DOMAIN_ID PAGE_RULE_ID (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
PAGE_RULE_ID
ページルールのID。 必須。
--json VALUE
ページルールを記述するために使用される JSON ファイルまたは JSON 文字列。 必須。
  • JSON データにおける必須フィールドは targets および です: actions
    • targets: リクエストに対して評価を行う対象の URL パターン。
    • actions: このルールの対象がリクエストと一致した場合に実行される一連のアクション。 以下のアクションが使用可能です。
      • disable_security
      • always_use_https
      • ssl
      • browser_cache_ttl
      • security_level
      • cache_level
      • edge_cache_ttl
      • bypass_cache_on_cookie
      • browser_check
      • server_side_exclude
      • email_obfuscation
      • automatic_https_rewrites
      • opportunistic_encryption
      • ip_geolocation
      • explicit_cache_control
      • cache_deception_armor
      • waf
      • forwarding_url
      • 非推奨。 image_load_optimization
      • image_size_optimization
      • script_load_optimization
      • host_header_override
      • resolve_override
      • 一部の機能はEnterpriseプランに限定されています:
        • cache_on_cookie
        • disable_apps
        • disable_performance
        • minify
        • origin_error_page_pass_thru
        • response_buffering
        • true_client_ip_header
        • sort_query_string_for_cache
        • respect_strong_etag
  • オプションのフィールドは priority および です: status
    • priority: あるページルールが別のルールよりも優先される度合いを示す数値。 デフォルト値は1です。
    • status: ページルールのステータス。 有効な値は active と disabled。 デフォルト値は disabledです。

サンプル JSON データ:

{
   "targets": [
      {
            "target": "url",
            "constraint": {
               "operator": "matches",
               "value": "*example.com/images/*"
            }
      }
   ],
   "actions": [
      {
            "id": "ssl",
            "value": "flexible"
      },
      {
            "id": "browser_cache_ttl",
            "value": 14400
      },
      {
            "id": "security_level",
            "value": "medium"
      },
      {
            "id": "cache_level",
            "value": "basic"
      },
      {
            "id": "edge_cache_ttl",
            "value": 7200
      },
      {
            "id": "bypass_cache_on_cookie",
            "value": "wp-.*|wordpress.*|comment_.*"
      }
   ]
}
-s, --json-str
非推奨。 ページ・ルールを記述する JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ページのルールを更新する PAGE_RULE_ID。

ibmcloud cis page-rule-update DNS_DOMAIN_ID PAGE_RULE_ID --json '{"targets":[{"target":"url", "constraint":{"operator":"matches", "value":"*example.com/images/*"}}], "actions":[{"id":"always_online", "value":"on"}],"priority":1, "status":"active"}' --output json

ibmcloud cis page-rule-delete

DNS ドメインのページ・ルールを削除します。

ibmcloud cis page-rule-delete DNS_DOMAIN_ID PAGE_RULE_ID [-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
PAGE_RULE_ID
ページルールのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

ページルールを削除する PAGE_RULE_ID。

ibmcloud cis page-rule-delete DNS_DOMAIN_ID PAGE_RULE_ID

ibmcloud cis page-rules

DNS ドメインのページ・ルールをリストします。

ibmcloud cis page-rules DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン内のすべてのページルールを一覧表示する DNS_DOMAIN_ID。

ibmcloud cis page-rules DNS_DOMAIN_ID --output json

ibmcloud cis page-rule

ページ・ルールの詳細を取得します。

ibmcloud cis page-rule DNS_DOMAIN_ID PAGE_RULE_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
PAGE_RULE_ID
ページルールのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ページルールの詳細を確認する PAGE_RULE_ID。

ibmcloud cis page-rule DNS_DOMAIN_ID PAGE_RULE_ID --output json

「範囲」アプリ

次のコマンド range-app を使用して、Range Appの動作を制御します:

ibmcloud cis range-app-create

Enterprise Plans Only

新規範囲アプリケーションを作成します。

ibmcloud cis range-app-create DNS_DOMAIN_ID --name NAME --edge-port EDGE_PORT --origin-direct ORIGIN_DIRECT [--origin-direct ORIGIN_DIRECT] [--proxy-protocol on|off] [--ip-firewall on|off] [--edge-connectivity all|ipv4|ipv6] [--edge-tls off|flexible|full|strict] [--traffic-type direct/http/https] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis range-app-create DNS_DOMAIN_ID --name NAME --edge-port EDGE_PORT --origin-lb-name ORIGIN_LB_NAME --origin-lb-port ORIGIN_LB_PORT [--proxy-protocol on|off] [--ip-firewall on|off] [--edge-connectivity all|ipv4|ipv6] [--edge-tls off|flexible|full|strict] [--traffic-type direct/http/https] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis range-app-create DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis range-app-create DNS_DOMAIN_ID -s JSON_STR [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis range-app-create DNS_DOMAIN_ID -j JSON_FILE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--name
range アプリケーションの DNS レコード名。
--edge-port
CIS のエッジでのポート構成。 デフォルト値は 22です。
--origin-direct
起点への宛先アドレス。
--origin-lb-name
rangeアプリケーションに関連付けられたロードバランサーの名前。
--origin-lb-port
rangeアプリケーションに関連付けられたロードバランサーのポート。 デフォルト値は 22です。
--protocol
プロトコル・タイプ。 有効な値は tcp および udp です。 UDP プロトコル・サポートは早期アクセスに含まれます。Range UDP アプリを作成する前にカスタム UDP を CIS ダッシュボードから要求してください。 デフォルト値はtcpです。
--proxy-protocol
起点への Proxy Protocol を有効にします。 有効な値は on, off, v1, v2, simple。デフォルト値は off です。 非推奨。 値 on は v1 と同等です。
--ip-firewall
このアプリケーションのIPファイアウォールを有効にするかどうかを制御します。 有効な値は on および off です。 デフォルト値はoffです。
--edge-connectivity
任意のアニキャスト IP 範囲におけるインバウンド接続でサポートされる IP バージョン。 有効な値は all, ipv4, ipv6 です。デフォルト値は all です。
--edge-tls
アプリケーションに関連付けられた TLS 終端のタイプ。 有効な値は off, flexible, full, strict です。デフォルト値は off です。
--traffic-type
データをエッジから起点に移動する方法を決定します。 有効な値は direct, http, https です。デフォルト値は direct です。
--json
範囲アプリケーションを記述するために使用される JSON ファイルまたは JSON 文字列。
  • JSON データにおける必須フィールドは protocol および です dns。
    • protocol : CIS のエッジにおけるポート設定。
    • dns: 範囲アプリケーションの DNS レコードの名前とタイプ。
      • name: 範囲アプリケーションの DNS レコード名。
      • type: アプリケーションに関連付けられた DNS レコードの種類。 有効な値は です CNAME。
  • オプションのフィールドは origin_direct、 origin_dns、 origin_port、、 proxy_protocol、 ip_firewall、 edge_ips、 tls、および です traffic_type。
    • origin_direct: 送信元への宛先アドレスの一覧。
    • origin_dns: DNS を通じてオリジンサーバーのアドレスを特定するために使用される方法とパラメータ。
      • name: DNSレコード名。
    • origin_port: 送信元における宛先ポート。
    • proxy_protocol: オリジンへのプロキシプロトコルを有効にします。 有効な値は on, off, v1, v2, simple。デフォルト値は off です。 非推奨. 値 on は v1 と同等です。
    • ip_firewall このアプリケーションのIPファイアウォールを有効にするかどうかを制御します。 有効な値は on と off。
    • edge_ips: このアプリケーションのホスト名に対するエニーキャスト・エッジ IP の設定。
      • type: 指定されたエッジ IP 設定の種類。 動的に割り当てられたエッジ IP は、指定した接続に従って、range エニーキャスト IP を使用します。 有効な値は です dynamic。
      • connectivity: 任意のキャスト IP アドレス範囲におけるインバウンド接続でサポートされる IP バージョン。 有効な値は、all、ipv4、ipv6 です。
    • tls: アプリケーションに関連付けられた TLS 終端のタイプ。 有効な値は off、 flexible、 full、 です strict。
    • traffic_type: データがエッジからオリジンへどのように伝送されるかを決定します。 に設定すると direct、range はトラフィックをオリジンに直接送信し、アプリケーションのタイプはプロトコルから判別されます。 に設定すると http``https 、range はトラフィックをオリジンに送信する際に CIS の HTTP / HTTPS 機能を適用し、アプリケーションタイプはこのプロパティと完全に一致します。 有効な値は direct、 http、 です https。 デフォルト値はdirectです。

サンプル JSON データ:

{
   "protocol": "tcp/22",
   "dns": {
      "type": "CNAME",
      "name": "ssh.example.com"
   },
   "origin_direct": [
      "tcp://1.2.3.4:22",
      "tcp://1.2.3.4:23",
      "tcp://1.2.3.4:24"
   ],
   "proxy_protocol": false,
   "ip_firewall": false,
   "edge_ips": {
      "type": "dynamic",
      "connectivity": "all"
   },
   "tls": "full",
   "traffic_type": "direct"
}
{
   "protocol": "tcp/22",
   "dns": {
      "type": "CNAME",
      "name": "glb.example.com"
   },
   "origin_dns": {
      "name": "name-to-glb.example.com"
   },
   "origin_port": 22,
   "proxy_protocol": false,
   "ip_firewall": false,
   "edge_ips": {
      "type": "dynamic",
      "connectivity": "all"
   },
   "tls": "full",
   "traffic_type": "direct"
}
-s, --json-str
非推奨。 範囲アプリケーションを記述する JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

DNS_DOMAIN_ID ドメインの範囲アプリを作成する。

ibmcloud cis range-app-create DNS_DOMAIN_ID --json '{"protocol":"tcp/22", "dns":{"type":"CNAME","name":"ssh.example.com"}, "origin_direct":["tcp://1.2.3.4:22"], "proxy_protocol":"off", "ip_firewall":true, "tls":"full", "edge_ips":{"type":"dynamic", "connectivity":"all"}, "traffic_type":"direct"}'

ibmcloud cis range-app-update

Enterprise Plans Only

既存のアプリケーションの設定を更新します。

ibmcloud cis range-app-update DNS_DOMAIN_ID APP_ID --origin-direct ORIGIN_DIRECT [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis range-app-update DNS_DOMAIN_ID APP_ID [--add-origin-direct ORIGIN_DIRECT] [--remove-origin-direct ORIGIN_DIRECT] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis range-app-update DNS_DOMAIN_ID APP_ID [--origin-lb-name ORIGIN_LB_NAME] [--origin-lb-port ORIGIN_LB_PORT] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis range-app-update DNS_DOMAIN_ID APP_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis range-app-update DNS_DOMAIN_ID APP_ID -s JSON_STR [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis range-app-update DNS_DOMAIN_ID APP_ID -j JSON_FILE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
APP_ID
範囲アプリケーションのID。 必須。
--name
range アプリケーションの DNS レコード名。
--add-origin-direct
送信元に新しい宛先アドレスを追加します。
--remove-origin-direct
宛先アドレスを起点から削除します。
--origin-direct
起点への宛先アドレス。
--origin-lb-name
rangeアプリケーションに関連付けられたロードバランサーの名前。
--origin-lb-port
rangeアプリケーションに関連付けられたロードバランサーのポート。 デフォルト値は 22です。
--proxy-protocol
オリジンへのプロキシプロトコルを有効にします。 有効な値は on, off, v1, v2, simple。デフォルト値は off です。 非推奨。 値 on は v1 と同等です。
--ip-firewall
このアプリケーションのIPファイアウォールを有効にするかどうかを制御します。 有効な値は on および off です。 デフォルト値はoffです。
--edge-connectivity
任意のアニキャスト IP 範囲におけるインバウンド接続でサポートされる IP バージョン。 有効な値は all, ipv4, ipv6 です。デフォルト値は all です。
--edge-tls
アプリケーションに関連付けられた TLS 終端のタイプ。 有効な値は off, flexible, full, strict です。デフォルト値は off です。
--traffic-type
データをエッジから起点に移動する方法を決定します。 有効な値は direct, http, https です。デフォルト値は direct です。
--json
範囲アプリケーションを記述するために使用される JSON ファイルまたは JSON 文字列。
  • JSON データにおける必須フィールドは protocol および です dns。
    • protocol : CIS のエッジにおけるポート設定。
    • dns: 範囲アプリケーションの DNS レコードの名前とタイプ。
      • name: 範囲アプリケーションの DNS レコード名。
      • type: アプリケーションに関連付けられた DNS レコードの種類。 有効な値は です CNAME。
  • オプションのフィールドは origin_direct、 origin_dns、 origin_port、、 proxy_protocol、 ip_firewall、 edge_ips、 tls、および です traffic_type。
    • origin_direct: 送信元への宛先アドレスの一覧。
    • origin_dns: DNS を通じてオリジンサーバーのアドレスを特定するために使用される方法とパラメータ。
      • name: DNSレコード名。
    • origin_port: 送信元における宛先ポート。
    • proxy_protocol: オリジンに対してプロキシプロトコルを有効にします。 有効な値は on, off, v1, v2, simple。デフォルト値は off です。 非推奨. 値 on は v1 と同等です。
    • ip_firewall このアプリケーションのIPファイアウォールを有効にするかどうかを制御します。 有効な値は on と off。
    • edge_ips: このアプリケーションのホスト名に対するエニーキャスト・エッジ IP の設定。
      • type: 指定されたエッジ IP 設定の種類。 動的に割り当てられたエッジ IP は、指定した接続に従って、range エニーキャスト IP を使用します。 有効な値は です dynamic。
      • connectivity: range エニーキャスト IP でのインバウンド接続でサポートされる IP バージョン。 有効な値は all、 ipv4、 です ipv6。
    • tls: アプリケーションに関連付けられた TLS 終端のタイプ。 有効な値は off、 flexible、 full、 です strict。
    • traffic_type: データがエッジからオリジンへどのように伝送されるかを決定します。 に設定すると direct、range はトラフィックをオリジンに直接送信し、アプリケーションのタイプはプロトコルから判別されます。 に設定すると http``https 、range はトラフィックをオリジンに送信する際に CIS の HTTP / HTTPS 機能を適用し、アプリケーションタイプはこのプロパティと完全に一致します。 有効な値は direct、 http、 です https。 デフォルト値はdirectです。

サンプル JSON データ:

{
   "protocol": "tcp/22",
   "dns": {
      "type": "CNAME",
      "name": "ssh.example.com"
   },
   "origin_direct": [
      "tcp://1.2.3.4:22",
      "tcp://1.2.3.4:23",
      "tcp://1.2.3.4:24"
   ],
   "proxy_protocol": false,
   "ip_firewall": false,
   "edge_ips": {
      "type": "dynamic",
      "connectivity": "all"
   },
   "tls": "full",
   "traffic_type": "direct"
}
{
   "protocol": "tcp/22",
   "dns": {
      "type": "CNAME",
      "name": "glb.example.com"
   },
   "origin_dns": {
      "name": "name-to-glb.example.com"
   },
   "origin_port": 22,
   "proxy_protocol": false,
   "ip_firewall": false,
   "edge_ips": {
      "type": "dynamic",
      "connectivity": "all"
   },
   "tls": "full",
   "traffic_type": "direct"
}
-s, --json-str
非推奨。 範囲アプリケーションを記述する JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

範囲アプリを更新する APP_ID。

ibmcloud cis range-app-update DNS_DOMAIN_ID APP_ID --json '{"protocol":"tcp/22", "dns":{"type":"CNAME","name":"ssh.example.com"}, "origin_direct":["tcp://1.2.3.4:22"], "proxy_protocol":"off", "ip_firewall":true, "tls":"full", "edge_ips":{"type":"dynamic", "connectivity":"all"}, "traffic_type":"direct"}'

ibmcloud cis range-app-delete

Enterprise Plans Only

以前から存在しているアプリケーションを削除します。

ibmcloud cis range-app-delete DNS_DOMAIN_ID APP_ID [--instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
APP_ID
範囲アプリケーションのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

範囲の削除を適用する APP_ID。

ibmcloud cis range-app-delete DNS_DOMAIN_ID APP_ID

ibmcloud cis range-app

Enterprise Plans Only

特定アプリケーションのアプリケーション構成を取得します。

ibmcloud cis range-app DNS_DOMAIN_ID APP_ID [--instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
APP_ID
範囲アプリケーションのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

範囲の適用に関する詳細を表示する APP_ID。

ibmcloud cis range-app DNS_DOMAIN_ID APP_ID

ibmcloud cis range-apps

Enterprise Plans Only

DNS ドメインに対して現在存在する範囲アプリケーションの一覧を取得します。

ibmcloud cis range-apps DNS_DOMAIN_ID [--instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン内のすべてのレンジアプリケーションをリストアップします。

ibmcloud cis range-apps DNS_DOMAIN_ID

ibmcloud cis range-analytics

Enterprise Plans Only

範囲アプリケーションのアナリティクス・データを取得します。

ibmcloud cis range-analytics DNS_DOMAIN_ID [--metrics METRICS] [--dimensions DIMENSION] [--filters FILTERS] [--sort SORT] [--since SINCE] [--until UNTIL]
ibmcloud cis range-analytics DNS_DOMAIN_ID --bytime [--time_delta DELTA] [--metrics METRICS] [--dimensions DIMENSION] [--filters FILTERS] [--sort SORT] [--since SINCE] [--until UNTIL]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--metrics
計算する 1 つ以上のメトリック。 すべてのメトリックを取得するには、メトリックを count,bytesIngress,bytesEgress,durationAvg,durationMedian,duration90th,duration99th に設定します。
--dimension
属性ごとにデータを分類するために使用できます。 すべてのディメンションを取得するには、ディメンションを event,appID,coloName,ipVersion に設定します。 --filters
1 つ以上のディメンションで行をフィルターするために使用されます。 フィルターは、ブール演算子のORおよびANDを使用して組み合わせることができます。 すべての式において AND は OR よりも優先されます。 OR演算子は、コンマ(,)またはORというキーワードを空白で囲むことで定義されます。 AND 演算子は、セミコロン (;) または AND キーワードを空白で囲むことで定義されます。 比較対象は ==、 !=``>{比較対象 <``>=}です <=。 フィルターの値の例: event==connect AND coloName!=SFO
--sort
結果セットのソート順。 ソート・フィールドがメトリックまたはディメンションに含まれている必要があります。 ソートの値の例: +count,-bytesIngress。
--since
照会する時間間隔の開始時刻。デフォルトは終了時刻の 6 時間前です。 この値は、RFC 3339 に準拠した絶対タイムスタンプでなければなりません。
--until
照会する時間間隔の終了時刻。デフォルトは現在の時刻です。 この値は、RFC 3339 に準拠した絶対タイムスタンプでなければなりません。
--bytime
時間間隔ごとにグループ化された、各種アプリケーション向けの分析データ。
--time-delta
時間間隔を選択するために使用されます。 有効な値は year, quarter, month, week, day, hour, dekaminute, minute。 --bytime が指定された場合のみ有効。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

当該分野におけるさまざまなアプリケーション向けの分析データを取得する。

ibmcloud cis range-analytics DNS_DOMAIN_ID --metrics "count,bytesIngress" --dimensions "event,appID" --since "2020-05-22T02:20:00Z" --until "2020-05-23T02:20:00Z"

速度制限

以下の ratelimit コマンドを使用して、レート制限を扱います。

ibmcloud cis ratelimit-rule-create

Enterprise Plans Only

DNS ドメインに対して新しいレート制限ルールを作成します。

ibmcloud cis ratelimit-rule-create DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis ratelimit-rule-create DNS_DOMAIN_ID --url URL [--description DESCRIPTION] [--threshold NUM] [--period SECONDS] [...]
[Deprecated] ibmcloud cis ratelimit-rule-create DNS_DOMAIN_ID --json-str JSON_STR [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis ratelimit-rule-create DNS_DOMAIN_ID --json-file JSON_FILE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--json
レート制限ルールを記述するために使用されるJSONファイルまたはJSON文字列。
  • JSON データにおける必須フィールドは match、、 threshold、 period 、 です: action
    • match: レート制限ルールが、どのトラフィックをしきい値の算定対象とするかを決定します。
      • request: HTTP リクエストに一致します。
        • methods: HTTP メソッドは、その一部、 [POST,PUT] あるいはすべてを含む場合があります [_ALL_]。 レート制限ルールを作成する際、このフィールドは必須ではありません。 有効な値は、GET、POST、PUT、DELETE、PATCH、HEAD、_ALL_ です。
        • schemes: HTTP スキームは、いずれか1つ [HTTPS]、両方 [HTTP、HTTPS] またはすべてである可能性があります [_ALL_]。 このフィールドは必須ではありません。
        • url: ホストとパスで構成される、一致させる URL パターン。例: example.org/path。 ワイルドカードは適用可能なトラフィックを一致させるために拡張されます。照会ストリングは一致されません。 ゾーンへのすべてのトラフィックには * を使用します。 最大文字数は です 1024。
      • response: クライアントに返される前に、 HTTP レスポンスと照合します。 これが定義されると、トラフィックの全体の合計がこのステージで発生します。
        • status: HTTP ステータスコード。1つ [403]、複数、 [401,403] またはこの値を指定しないことですべてを示すことができます。 このフィールドは必須ではありません。 最小値は 100、最大値は 999。
        • headers: 照合対象のレスポンスヘッダーの配列。 レスポンスがヘッダーの基準を満たさない場合、そのリクエストはレート制限ルールの対象としてカウントされません。 ヘッダーの一致条件には、以下のプロパティが含まれます。
          • name: 照合するレスポンスヘッダーの名前。
          • op: 演算子の意味:eq は等しい、ne は等しくないを意味します。 有効な値は eq と ne。
          • value: ヘッダーの値(完全一致)。
    • threshold: レート制限の緩和措置がトリガーされる閾値。これには期間が組み合わされます。 例えば、期間ごとのしきい値など。 最小値は 2、最大値は 1000000。
    • period: 一致するトラフィックをカウントするのにかかる時間(秒単位)。 この期間内にカウントが閾値を超えた場合、そのアクションが実行されます。 最小値は 10 、最大値は 86400。
    • action: 定義された期間内における一致したトラフィックの閾値を超えた場合に実行されるアクション。
      • mode: 実行されるアクションの種類。 有効な値は、simulate、ban、challenge、js_challenge です。
      • timeout: 緩和措置を実行するための時間を秒単位で、整数として指定します。 タイムアウトは、その期間と同じか、それ以上である場合があります。 このフィールドは、モードが simulate または の場合にのみ有効です ban。 最小値は 10 、最大値は 86400。
      • response: 返すカスタムコンテンツタイプと本文。 これはゾーンのカスタム・エラーをオーバーライドします。 このフィールドは必須ではありません。 指定しないと、デフォルトの HTML エラー・ページが使用されます。 このフィールドはモードが simulate または ban のときのみ有効です。
        • content_type: 本文のコンテンツタイプ。以下のいずれかである必要があります: text/plain, text/xml, application/json。
        • body: 返すべき本文。 この内容は、content_type と一致する必要があります。 最大文字数は です 10240。
  • オプション・フィールドは、id、disabled、description、correlate、および bypass です。
    • id: レート制限ルールの識別子。
    • disabled: このレート制限ルールが現在無効になっているかどうか。
    • description: レート制限ルールの理由を説明するために使用できる注記。
    • correlate: NAT ベースのレート制限を有効にするかどうか。
      • by 有効な値は。 nat
    • bypass: レート制限をバイパスできる条件。 例えば、一連のURLに対してレート制限を適用すべきではないことを表現する場合など。
      • name 有効な値は。 url
      • value: バイパスするURL。

サンプル JSON データ:

{
   "id": "92f17202ed8bd63d69a66b86a49a8f6b",
   "disabled": false,
   "description": "Prevent multiple login failures to mitigate brute force attacks",
   "bypass": [
      {
         "name": "url",
         "value": "api.example.com/*"
      }
   ],
   "threshold": 60,
   "period": 900,
   "correlate": {
      "by": "nat"
   },
   "action": [
      {
         "mode": "simulate",
         "timeout": 86400,
         "response": {
            "content_type": "text/plain",
            "body": "<error>This request has been rate-limited.</error>"
         }
      }
   ],
   "match": {
      "request": {
               "methods": [
                  "GET"
               ],
               "schemes": [
                  "HTTP",
                  "HTTPS"
               ],
               "url": "*.example.org/path*"
      },
      "response": {
         "status": [
               403, 401
         ],
         "headers": [
            {
               "name": "Cf-Cache-Status",
               "op": "eq",
               "value": "HIT"
            }
         ]
      }
   }
}
-s, --json-st
非推奨。 レート制限ルールを記述する JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのレート制限ルールを作成します。

ibmcloud cis ratelimit-rule-create DNS_DOMAIN_ID --json '{"id":"372e67954025e0ba6aaa6d586b9e0b59","disabled":false,"description":"Prevent multiple login failures to mitigate brute force attacks","match":{"request":{"methods":["GET","POST"],"schemes":["HTTP","HTTPS"],"url":"*.example.org/path*"},"response":{"status": [403, 401],"headers":[{"name":"Cf-Cache-Status","op":"ne","value":"HIT"}]}},"bypass":[{"name":"url","value":"api.example.com/*"}],"threshold":60,"period":900,"action":{"mode":"challenge","timeout":86400,"response":{"content_type":"text/xml","body":"<error>This request has been rate-limited.</error>"}}}'

ibmcloud cis ratelimit-rule-update

DNS ドメインのレート制限ルールを更新します。

ibmcloud cis ratelimit-rule-update DNS_DOMAIN_ID RATELIMIT_RULE_ID  (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis ratelimit-rule-update DNS_DOMAIN_ID RATELIMIT_RULE_ID [--url URL] [--description DESCRIPTION] [--threshold NUM] [--period SECONDS] [...]
[Deprecated] ibmcloud cis ratelimit-rule-update DNS_DOMAIN_ID RATELIMIT_RULE_ID --json-str JSON_STR [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis ratelimit-rule-update DNS_DOMAIN_ID RATELIMIT_RULE_ID --json-file JSON_FILE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
RATELIMIT_RULE_ID
レート制限ルールのID。 必須。
--json
レート制限ルールを記述するために使用されるJSONファイルまたはJSON文字列。
  • JSON データにおける必須フィールドは match、、 threshold、 period 、 です: action
    • match: レート制限ルールが、どのトラフィックをしきい値の算定対象とするかを決定します。
      • request: HTTP リクエストに一致します。
        • methods: HTTP メソッドは、その一部、 [POST,PUT] あるいはすべてを含む場合があります [ALL]。 レート制限ルールを作成する際、このフィールドは必須ではありません。 有効な値は、GET、POST、PUT、DELETE、PATCH、HEAD、ALL です。
        • schemes: HTTP スキームは、1つ [HTTPS]、両方、 [HTTP,HTTPS] またはすべてを指定できます [_ALL_]。 このフィールドは必須ではありません。
        • url: 一致させる URL パターンは、ホストとパスで構成されていました。例えば、 example.org/path. ワイルドカードは適用可能なトラフィックを一致させるために拡張されます。照会ストリングは一致されません。 ゾーンへのすべてのトラフィックには * を使用します。 最大文字数は です 1024。
      • response: クライアントに返される前に、 HTTP レスポンスと照合します。 このフィールドが定義されている場合、トラフィックの集計はすべてこの段階で実行されます。
        • status: HTTP ステータスコード。1つ [403]、複数、 [401,403] またはこの値を指定しないことですべてを示すことができます。 このフィールドは必須ではありません。 最小値は 100 、最大値は 999。
        • headers: 照合対象のレスポンスヘッダーの配列。 レスポンスがヘッダーの基準を満たさない場合、そのリクエストはレート制限ルールの対象としてカウントされません。 ヘッダーの一致条件には、以下のプロパティが含まれます。
          • name: 照合するレスポンスヘッダーの名前。
          • op: 演算子の意味:eq は等しい、ne は等しくないを意味します。 有効な値は eq と ne。
          • value: ヘッダーの値(完全一致)。
    • threshold: レート制限の緩和措置をトリガーする閾値。これは期間と組み合わせて適用されます。 例えば、期間ごとのしきい値など。 最小値は 2 、最大値は 1000000。
    • period: 一致するトラフィックをカウントするのにかかる時間(秒単位)。 この期間内にカウントが閾値を超えた場合、そのアクションが実行されます。 最小値は 1 、最大値は 3600。
    • action: 定義された期間内に一致したトラフィックの閾値を超えた場合に、このアクションが実行されます。
      • mode: 実行されるアクションの種類。 有効な値は simulate、 ban、 challenge、 です js_challenge。
      • timeout: 緩和措置を実行するのにかかる時間を秒単位で、整数で指定します。 タイムアウトは、その期間と同じかそれ以上です。 このフィールドはモードが simulate または ban のときのみ有効です。 最小値は 10 、最大値は 86400。
      • response: 返すカスタムコンテンツタイプと本文。 これはゾーンのカスタム・エラーをオーバーライドします。 このフィールドは必須ではありません。 指定しないと、デフォルトの HTML エラー・ページが使用されます。 このフィールドはモードが simulate または ban のときのみ有効です。
        • content_type: 本文のコンテンツタイプ。以下のいずれかである必要があります: text/plain, text/xml, application/json。
        • body: 返すべき本文。 この内容は、content_type と一致する必要があります。 最大文字数は です 10240。
  • オプション・フィールドは、disabled、description、correlate、および bypass です。
    • disabled: このレート制限ルールが現在無効になっているかどうか。
    • description: レート制限ルールの理由を説明するために使用できる注記。
    • correlate: NAT ベースのレート制限を有効にするかどうか。
      • by 有効な値は。 nat
    • bypass: レート制限をバイパスできる条件。 例えば、一連のURLに対してレート制限を適用すべきではないことを表現する場合など。
      • name 有効な値は。 url
      • value: バイパスするURL。

サンプル JSON データ:

{
   "disabled": false,
   "description": "Prevent multiple login failures to mitigate brute force attacks",
   "bypass": [
      {
         "name": "url",
         "value": "api.example.com/*"
      }
   ],
   "threshold": 60,
   "period": 900,
   "correlate": {
      "by": "nat"
   },
   "action": [
      {
         "mode": "simulate",
         "timeout": 86400,
         "response": {
            "content_type": "text/plain",
            "body": "<error>This request has been rate-limited.</error>"
         }
      }
   ],
   "match": {
      "request": {
               "methods": [
                  "GET"
               ],
               "schemes": [
                  "HTTP",
                  "HTTPS"
               ],
               "url": "*.example.org/path*"
      },
      "response": {
         "status": [
               403, 401
         ],
         "headers": [
            {
               "name": "Cf-Cache-Status",
               "op": "eq",
               "value": "HIT"
            }
         ]
      }
   }
}
-s, --json-str
非推奨。 レート制限ルールを記述する JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのレート制限ルールを更新します。

ibmcloud cis ratelimit-rule-update DNS_DOMAIN_ID RATELIMIT_RULE_ID --json '{"disabled":false,"description":"Prevent multiple login failures to mitigate brute force attacks","match":{"request":{"methods":["GET","POST"],"schemes":["HTTP","HTTPS"],"url":"*.example.org/path*"},"response":{"status": [403, 401],"headers":[{"name":"Cf-Cache-Status","op":"ne","value":"HIT"}]}},"bypass":[{"name":"url","value":"api.example.com/*"}],"threshold":60,"period":900,"action":{"mode":"challenge","timeout":86400,"response":{"content_type":"text/xml","body":"<error>This request has been rate-limited.</error>"}}}'

ibmcloud cis ratelimit-rules

DNS ドメインのレート制限ルールを一覧表示します。

ibmcloud cis ratelimit-rules DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン内のレート制限ルールを一覧表示します。

ibmcloud cis ratelimit-rules DNS_DOMAIN_ID

ibmcloud cis ratelimit-rule

レート制限ルールの詳細を ID 指定で取得します。

ibmcloud cis ratelimit-rule DNS_DOMAIN_ID  RATELIMIT_RULE_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
RATELIMIT_RULE_ID
レート制限ルールのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

レート制限ルールの詳細を確認する。

ibmcloud cis ratelimit-rule DNS_DOMAIN_ID RATELIMIT_RULE_ID

ibmcloud cis ratelimit-rule-delete

レート制限ルールを ID 指定で削除します。

ibmcloud cis ratelimit-rule-delete DNS_DOMAIN_ID RATELIMIT_RULE_ID [--instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
RATELIMIT_RULE_ID
レート制限ルールのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

速度制限ルールを削除します。

ibmcloud cis ratelimit-rule-delete DNS_DOMAIN_ID RATELIMIT_RULE_ID

リソース・インスタンス

以下の instance コマンドを使用して、CIS サービス・インスタンスを扱います。

ibmcloud cis instances

すべての CIS サービス・インスタンスをリストします。

ibmcloud cis instances [--output FORMAT]

コマンド・オプション

--output
出力形式。 現在、 が唯一サポートされている値です json。

例

現行アカウントのすべての CIS インスタンスをリストします。

ibmcloud cis instances

ibmcloud cis instance-set

コンテキスト・サービス・インスタンスを動作させるように設定します。

ibmcloud cis instance-set [INSTANCE_NAME] [--unset]

コマンド・オプション

INSTANCE_NAME
CIS サービスインスタンスの名前。 それが表示されている場合は、コンテンツ・インスタンスが動作するように設定します。表示されていない場合は、現在のコンテキスト・インスタンスを表示します。
--unset
コンテキスト・インスタンスを設定解除します。

例

コンテキスト・サービス・インスタンスを次のように設定します。 cis-demo

ibmcloud cis instance-set cis-demo

ibmcloud cis instance-create

CIS サービス・インスタンスを作成します。

ibmcloud cis instance-create INSTANCE_NAME PLAN [--output FORMAT]

コマンド・オプション

INSTANCE_NAME
CIS サービスインスタンスの名前。 必須。
PLAN
サービス・プランの名前または ID。 必須。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

Standard-Nextプランの CIS インスタンスを作成する cis-demo

ibmcloud cis instance-create cis-demo standard-next

ibmcloud cis instance-delete

CIS サービス・インスタンスを削除します。

ibmcloud cis instance-delete INSTANCE [-f, --force]

コマンド・オプション

INSTANCE
CIS サービスインスタンスの名前またはID。 必須。
-f, --force
確認のプロンプトを出さずにインスタンスを削除します。

例

cis インスタンス cis-demo を削除します。

ibmcloud cis instance-delete cis-demo --force

ibmcloud cis instance-update

CIS サービス・インスタンスを更新します。

ibmcloud cis instance-update INSTANCE [--name NAME] [--plan PLAN]  [--output FORMAT]

コマンド・オプション

INSTANCE
CIS サービスインスタンスの名前またはID。 必須。
NAME
CIS サービスインスタンスの名前。
PLAN
サービス・プランの名前または ID。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

cis インスタンス cis-demo をエンタープライズ使用プランに更新します。

ibmcloud cis instance-update cis-demo --plan enterprise-usage

ibmcloud cis instance

CIS サービス・インスタンスの詳細を表示します。

ibmcloud cis instance INSTANCE [--output FORMAT]

コマンド・オプション

INSTANCE
CIS サービスインスタンスの名前またはID。 必須。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

cis インスタンス cis-demo の詳細を表示します。

ibmcloud cis instance cis-demo

ibmcloud cis plans

すべての CIS サービス・プランをリストします。

ibmcloud cis plans [--refresh] [--output FORMAT]

コマンド・オプション

--refresh
カタログから強制的にリフレッシュします。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

CIS サービス・プランをリストします。

ibmcloud cis plans --refresh

ルーティング

以下の routing コマンドを使用して、経路指定を扱います。

ibmcloud cis routing

Enterprise Plans Only

経路指定設定の詳細を取得します。

ibmcloud cis routing DNS_DOMAIN_ID (--smart-routing | --tiered-caching) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--smart-routing
リアルタイムのネットワークインテリジェンスを活用し、トラフィックをオリジンから CIS データセンターまでの経路にルーティングします。
--tiered-caching
Regional Tier 1 CIS データ・センターを使用してコンテンツ配信を高速にします。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのルーティング設定の詳細を確認する。

ibmcloud cis routing DNS_DOMAIN_ID --smart-routing

ibmcloud cis routing-update

Enterprise Plans Only

経路指定設定を更新します。

ibmcloud cis routing-update DNS_DOMAIN_ID (--smart-routing (on|off) | --tiered-caching (on|off)) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--smart-routing
リアルタイムのネットワークインテリジェンスを活用し、トラフィックをオリジンから CIS データセンターまでの経路にルーティングします。 有効な値は、on、off です。
--tiered-caching
Regional Tier 1 CIS データ・センターを使用してコンテンツ配信を高速にします。 有効な値は on および off です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 372e67954025e0ba6aaa6d586b9e0b60 の経路指定設定を更新します。

ibmcloud cis routing-update 31984fea73a15b45779fa0df4ef62f9b --smart-routing on --instance "cis-demo"

ibmcloud cis routing-analytics

Enterprise Plans Only

smart-routing 遅延のアナリティクスを取得します。

ibmcloud cis routing-analytics DNS_DOMAIN_ID [--colos] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--colos
smart-routing 遅延コロケーションのアナリティクス。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 372e67954025e0ba6aaa6d586b9e0b60 の smart-routing 遅延のアナリティクスを取得します。

ibmcloud cis routing-analytics 31984fea73a15b45779fa0df4ef62f9b --instance "cis-demo"

セキュリティー・イベント (非推奨)

セキュリティ・イベントは2020年10月26日に廃止される。 代わりに ibmcloud cis firewall-event-analytics を使用してください。 次のコマンド security-events を使用して、セキュリティイベントの動作を管理します:

ibmcloud cis security-events

security-events コマンドは、firewall-events コマンドの代わりに使用されます。 最大30日分のセキュリティイベントを取得可能です。これらのイベントは、ファイアウォール以外の、レート制限、 L7DDoS, ブラウザの整合性チェックなど、より多様なソースによってトリガーされる可能性があります。 新規 security-events コマンドを使用すると、--source オプションを指定することで、ファイアウォール・イベントのみをリストできます。

ファイアウォール・ルール、レート制限、セキュリティレベル、アクセス・ルール、WAF、ユーザー・エージェントのブロック、ゾーン・ロックダウン、および高度な DDoS 対策を含む、セキュリティ・イベントの完全なログを取得します。

ibmcloud cis security-events DNS_DOMAIN_ID [--ip-class IP_CLASS] [--method METHOD] [--scheme SCHEME] [--ip IP_ADDR] [--host HOSTNAME] [--protocol PROTOCOL] [--uri URI] [--ua USER_AGENT] [--colo COLO] [--ray-id RAY_ID] [--kind KIND] [--action ACTION] [--cursor CURSOR] [--country COUNTRY] [--since START_DATE] [--until END_DATE] [--source SOURCE] [--limit LIMIT] [--rule_id RULE_ID] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--ip-class
IP クラスは、クライアント IP の訪問者分類へのマップです。 有効な値は unknown、 clean、 badHost、 searchEngine、、 whitelist、 greylist、 monitoringService、 securityScanner、 noRecord、 scan、 backupService、 mobilePlatform、 です tor。
--method
要求の HTTP メソッド。 有効な値は GET、 POST、 DELETE、 PUT、 HEAD、 PURGE、 OPTIONS、 PROPFIND、 MKCOL、 PATCH、 ACL、 BCOPY、 BDELETE、 BMOVE、 BPROPFIND、 BPROPPATCH、 CHECKIN、 CHECKOUT、 CONNECT、 COPY、、 LABEL、 LOCK、 MERGE、 MKACTIVITY``MKWORKSPACE、 MOVE、 NOTIFY、 ORDERPATCH、 POLL、 PROPPATCH、 REPORT、 SEARCH、 SUBSCRIBE、 TRACE、 UNCHECKOUT、、 UNLOCK、 UNSUBSCRIBE、 UPDATE、 VERSION-CONTROL、 BASELINE-CONTROL、 X-MS-ENUMATTS、 RPC_OUT_DATA、 RPC_IN_DATA、 JSON、 COOK、 です TRACK。
--scheme
URL のスキーム。 有効な値は、unknown、http、およびhttpsです。
--ip
要求の送信元となった IPv4 または IPv6 のアドレス。
--host
要求がアクセスしようとしたホスト名。
--protocol
要求のプロトコル。 有効な値は UNK、 HTTP/1.0、 HTTP/1.1、 HTTP/1.2、 HTTP/2 および です SPDY/3.1。
--uri
ホスト名から要求される URI。
--ua
要求を開始したクライアント・ユーザー・エージェント。
--colo
リクエストを処理した Cloudflare データセンターの 3 文字の空港コード。 例えば、SJC です。
--ray-id
要求のレイ ID。
--action
どのタイプのアクションが実行されたか。 有効な値は unknown、 allow、 drop、 challenge、、 jschallenge、、 simulate、 および connectionClose です log。
--cursor
limit パラメータによって結果の数が制限されている場合、次のレコードセットを要求する際のカーソルの位置と方向。 カーソルの有効な値は、result_info 構造内の cursors オブジェクトから取得できます。
--country
要求の送信元の 2 桁の国別コード。 例えば、US です。
--since
ISO8601 フォーマットでのデータ期間の開始日時。 1 年より前の日時にすることはできません。 例えば、2016-11-11T12:00:00Z です。
--until
ISO8601 フォーマットでのデータ期間の終了日時。 例えば、2016-11-11T12:00:00Z です。
--source
イベントのソース。 有効な値は unknown、 asn、 country、 ip、、 ipRange、 securityLevel、 zoneLockdown、 waf、 uaBlock、 rateLimit``firewallRules、 bic、 hot、、 です l7ddos。
--limit
返されるイベントの数。 クエリの対象となる時間範囲内にさらにイベントが存在する場合、cursor 属性を使用して次のイベントのバッチを順次処理することができます。 なお、制限が適用された場合、構造 result_info 内のパラメータ scanned_range は、現在の結果セットにおいてイベントがいつ考慮されたかを示す指標となります。 有効な値は 10 から 1000 です。 デフォルト値は 50 です。
--rule-id
イベントをトリガーしたルールのID。これは、発生源の文脈を考慮して解釈する必要があります。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のセキュリティー・イベントを取得します。

ibmcloud cis security-events 31984fea73a15b45779fa0df4ef62f9b --action challenge --colo SJC --country US --host "www.example.com" --ip-class clean
--method POST --ray-id 187d944c61940c77 --cursor "6yDGxLKVeeHZZmORS_8XeSuhz9SjIJRaSa2lnsF01tQOHrfTGAP3R5X1Kv5iVUuMbNKhWNAXHOl6ePB0TUL8nw" -i "cis-demo"

TLS

以下の tls コマンドを使用して、TLS を扱います。

ibmcloud cis tls-settings

ドメインの TLS 設定を取得する。

ibmcloud cis tls-settings DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 372e67954025e0ba6aaa6d586b9e0b60 のTLS 設定を取得します。

ibmcloud cis tls-settings 31984fea73a15b45779fa0df4ef62f9b --instance "cis-demo"

ibmcloud cis tls-settings-update

DNS ドメインの TLS 設定を更新します。

ibmcloud cis tls-settings-update DNS_DOMAIN_ID [--mode MODE] [--universal (true|false)] [--tls-1-2-only (on|off)] [--tls-1-3 (on|off)] [-i, --instance INSTANCE][--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--mode
訪問者がセキュアな接続を介してウェブサイトを閲覧できるかどうか、またその場合に CIS がオリジンサーバーにどのように接続するかを明記してください。 有効な値は off、 client-to-edge、 end-to-end-flexible、 end-to-end-ca-signed、 です https-only-origin-pull。 詳細な TLS モードの説明については、以下の文書リンクを参照してください。
--universal
お使いのドメインでユニバーサル SSL が有効になっているかどうかを指定してください。 有効な値は true および false です。
--tls-1-2-only
お使いのドメインで Crypto TLS 1.2 機能が有効になっているかどうかを指定してください。 この機能を有効にすることで、旧バージョンが使用されないようにすることができます。 有効な値は on および off です。
--tls-1-3
お使いのドメインで Crypto TLS 1.3 機能が有効になっているかどうかを指定してください。 有効な値は on、 です off。
--min-tls-version
指定されている TLS プロトコル・バージョン以上を使用する HTTPS 要求のみを受け入れます。 有効な値は 1.0、 1.1、 1.2、 です 1.3。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインの TLS 設定を更新します 372e67954025e0ba6aaa6d586b9e0b60。

ibmcloud cis tls-settings-update 31984fea73a15b45779fa0df4ef62f9b --mode end-to-end-ca-signed --tls-1-2-only on --instance "cis-demo"

ibmcloud cis certificates

DNS ドメインのすべての証明書(共有証明書、専用証明書、カスタム証明書を含む)を一覧表示します。

ibmcloud cis certificates DNS_DOMAIN_ID [--keyless] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--keyless
すべてのキーレス証明書をリストします。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のすべての証明書をリストします。

ibmcloud cis certificates 31984fea73a15b45779fa0df4ef62f9b --instance "cis-demo"

ibmcloud cis certificate

共有、専用、またはカスタム証明書の詳細を確認してください。

ibmcloud cis certificate DNS_DOMAIN_ID (--cert-id CERT_ID | --universal) [--keyless] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--cert-id
専用またはカスタム証明書のID。
--universal
ユニバーサル証明書の詳細を表示します。
--keyless
キーレス証明書の詳細を表示します。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

証明書の詳細を表示します。

ibmcloud cis certificate 31984fea73a15b45779fa0df4ef62f9b --universal --instance "cis-demo"
ibmcloud cis certificate 31984fea73a15b45779fa0df4ef62f9b --cert-id 5a7805061c76ada191ed06f989cc3dac --instance "cis-demo"
ibmcloud cis certificate 31984fea73a15b45779fa0df4ef62f9b --cert-id 5a7805061c76ada191ed06f989cc3dac --keyless --instance "cis-demo"

ibmcloud cis certificate-order

DNS ドメインのホスト名リスト(オプション)を含む証明書パックを注文します。

ibmcloud cis certificate-order DNS_DOMAIN_ID [--hostnames host1 --hostnames host2 ...] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--hostnames
証明書パックで有効なホスト名。 最大 50 個のカスタムホスト名を追加可能 - 料金に影響する場合があります。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b の証明書パックを注文します。

ibmcloud cis certificate-order 31984fea73a15b45779fa0df4ef62f9b --hostnames www.example.com --hostnames api.example.com --instance "cis-demo"

ibmcloud cis certificate-upload

DNS ドメインのカスタム証明書をアップロードします。

ibmcloud cis certificate-upload DNS_DOMAIN_ID [--keyless] (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis certificate-upload DNS_DOMAIN_ID [--keyless] (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--keyless
キーレス証明書をアップロードします。
--json
カスタム証明書を記述するために使用されるJSONファイルまたはJSON文字列。 必須。
  • JSON データにおける必須フィールドは certificate、 private_key、host 、および です: port
    • certificate :当該ドメイン用の SSL 証明書、または証明書と1つ以上の中間証明書。
    • private_key: ドメインの秘密鍵。
    • host: キーレス SSL のホスト名。
    • port: CIS とクライアントのKeyless SSL サーバー間の通信に使用されるKeyless SSL ポート。
  • オプションのフィールドは bundle_method および です: name
    • bundle_method: バンドル方式。デフォルト値は compatible、有効な値は compatible、 および modern です user-defined。
    • name: キーレス SSL の名称。

サンプル JSON データ:

{
   "certificate": "xxx",
   "private_key": "xxx",
   "bundle_method": "compatible"
}
For keyless ssl
{
    "host":"www.example.com",
    "port":8000,
    "certificate": "xxx",
    "bundle_method": "user-defined",
   "name": "test"
}
-s, --json-str
非推奨。 カスタム証明書をアップロードするために使用される JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメイン 31984fea73a15b45779fa0df4ef62f9b のカスタム証明書をアップロードします。

ibmcloud cis certificate-upload 31984fea73a15b45779fa0df4ef62f9b --json '{"certificate": "-----BEGIN CERTIFICATE-----\nMIIDtTCCAp2gAwIBAgIJAMHAwfXZ5/PWMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNV\nBAYTAkFVMRMwEQYDVQQIEwpTb21lLVN0YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBX\naWRnaXRzIFB0eSBMdGQwHhcNMTYwODI0MTY0MzAxWhcNMTYxMTIyMTY0MzAxWjBF\nMQswCQYDVQQGEwJBVTETMBEGA1UECBMKU29tZS1TdGF0ZTEhMB8GA1UEChMYSW50\nZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB\nCgKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmGdtcGbg/1\nCGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKnabIRuGvB\nKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpidtnKX/a+5\n0GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+pyFxIXjbEI\ndZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pEewooaeO2\nizNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABo4GnMIGkMB0GA1UdDgQWBBT/LbE4\n9rWf288N6sJA5BRb6FJIGDB1BgNVHSMEbjBsgBT/LbE49rWf288N6sJA5BRb6FJI\nGKFJpEcwRTELMAkGA1UEBhMCQVUxEzARBgNVBAgTClNvbWUtU3RhdGUxITAfBgNV\nBAoTGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZIIJAMHAwfXZ5/PWMAwGA1UdEwQF\nMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAHHFwl0tH0quUYZYO0dZYt4R7SJ0pCm2\n2satiyzHl4OnXcHDpekAo7/a09c6Lz6AU83cKy/+x3/djYHXWba7HpEu0dR3ugQP\nMlr4zrhd9xKZ0KZKiYmtJH+ak4OM4L3FbT0owUZPyjLSlhMtJVcoRp5CJsjAMBUG\nSvD8RX+T01wzox/Qb+lnnNnOlaWpqu8eoOenybxKp1a9ULzIVvN/LAcc+14vioFq\n2swRWtmocBAs8QR9n4uvbpiYvS8eYueDCWMM4fvFfBhaDZ3N9IbtySh3SpFdQDhw\nYbjM2rxXiyLGxB4Bol7QTv4zHif7Zt89FReT/NBy4rzaskDJY5L6xmY=\n-----END CERTIFICATE-----\n", "private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmG\ndtcGbg/1CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKn\nabIRuGvBKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpid\ntnKX/a+50GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+py\nFxIXjbEIdZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pE\newooaeO2izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABAoIBACbhTYXBZYKmYPCb\nHBR1IBlCQA2nLGf0qRuJNJZg5iEzXows/6tc8YymZkQE7nolapWsQ+upk2y5Xdp/\naxiuprIs9JzkYK8Ox0r+dlwCG1kSW+UAbX0bQ/qUqlsTvU6muVuMP8vZYHxJ3wmb\n+ufRBKztPTQ/rYWaYQcgC0RWI20HTFBMxlTAyNxYNWzX7RKFkGVVyB9RsAtmcc8g\n+j4OdosbfNoJPS0HeIfNpAznDfHKdxDk2Yc1tV6RHBrC1ynyLE9+TaflIAdo2MVv\nKLMLq51GqYKtgJFIlBRPQqKoyXdz3fGvXrTkf/WY9QNq0J1Vk5ERePZ54mN8iZB7\n9lwy/AkCgYEA6FXzosxswaJ2wQLeoYc7ceaweX/SwTvxHgXzRyJIIT0eJWgx13Wo\n/WA3Iziimsjf6qE+SI/8laxPp2A86VMaIt3Z3mJN/CqSVGw8LK2AQst+OwdPyDMu\niacE8lj/IFGC8mwNUAb9CzGU3JpU4PxxGFjS/eMtGeRXCWkK4NE+G08CgYEA1Kp9\nN2JrVlqUz+gAX+LPmE9OEMAS9WQSQsfCHGogIFDGGcNf7+uwBM7GAaSJIP01zcoe\nVAgWdzXCv3FLhsaZoJ6RyLOLay5phbu1iaTr4UNYm5WtYTzMzqh8l1+MFFDl9xDB\nvULuCIIrglM5MeS/qnSg1uMoH2oVPj9TVst/ir8CgYEAxrI7Ws9Zc4Bt70N1As+U\nlySjaEVZCMkqvHJ6TCuVZFfQoE0r0whdLdRLU2PsLFP+q7qaeZQqgBaNSKeVcDYR\n9B+nY/jOmQoPewPVsp/vQTCnE/R81spu0mp0YI6cIheT1Z9zAy322svcc43JaWB7\nmEbeqyLOP4Z4qSOcmghZBSECgYACvR9Xs0DGn+wCsW4vze/2ei77MD4OQvepPIFX\ndFZtlBy5ADcgE9z0cuVB6CiL8DbdK5kwY9pGNr8HUCI03iHkW6Zs+0L0YmihfEVe\nPG19PSzK9CaDdhD9KFZSbLyVFmWfxOt50H7YRTTiPMgjyFpfi5j2q348yVT0tEQS\nfhRqaQKBgAcWPokmJ7EbYQGeMbS7HC8eWO/RyamlnSffdCdSc7ue3zdVJxpAkQ8W\nqu80pEIF6raIQfAf8MXiiZ7auFOSnHQTXUbhCpvDLKi0Mwq3G8Pl07l+2s6dQG6T\nlv6XTQaMyf6n1yjzL+fzDrH3qXMxHMO/b13EePXpDMpY7HQpoLDi\n-----END RSA PRIVATE KEY-----\n", "bundle_method": "compatible"}' -i "cis-demo"

ibmcloud cis certificate-update

DNS ドメインのカスタム証明書を更新します。

ibmcloud cis certificate-update DNS_DOMAIN_ID CERT_ID [--keyless] (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis certificate-update DNS_DOMAIN_ID CERT_ID [--keyless] [-s, --json-str JSON_STR | -j, --json-file JSON_FILE] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
CERT_ID
カスタム証明書のID。 必須。
--keyless
キーレス証明書を更新します。
--json
カスタム証明書を記述するために使用されるJSONファイルまたはJSON文字列。 必須。
  • JSON データにおける必須フィールドは certificate、 private_key、host 、および です: port
    • certificate :当該ドメイン用の SSL 証明書、または証明書と1つ以上の中間証明書。
    • private_key: ドメインの秘密鍵。
    • host: キーレス SSL のホスト名。
    • port: CIS とクライアントのKeyless SSL サーバー間の通信に使用されるKeyless SSL ポート。
  • オプションのフィールドは以下の通りです: bundle_method
    • bundle_method: バンドル方式。デフォルト値は compatible、有効な値は compatible、 および modern です user-defined。
    • name: キーレス SSL の名称。

サンプル JSON データ:

{
   "certificate": "xxx",
   "private_key": "xxx",
   "bundle_method": "compatible"
}
For keyless ssl
{
    "host":"www.example.com",
    "port":8000,
    "certificate": "xxx",
    "bundle_method": "user-defined",
   "name": "test"
}
-s, --json-str
非推奨。 カスタム証明書を更新するために使用される JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

カスタム証明書を更新してください 5a7805061c76ada191ed06f989cc3dac。

ibmcloud cis certificate-update 31984fea73a15b45779fa0df4ef62f9b 5a7805061c76ada191ed06f989cc3dac --json '{"certificate": "-----BEGIN CERTIFICATE-----\nMIIDtTCCAp2gAwIBAgIJAMHAwfXZ5/PWMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNV\nBAYTAkFVMRMwEQYDVQQIEwpTb21lLVN0YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBX\naWRnaXRzIFB0eSBMdGQwHhcNMTYwODI0MTY0MzAxWhcNMTYxMTIyMTY0MzAxWjBF\nMQswCQYDVQQGEwJBVTETMBEGA1UECBMKU29tZS1TdGF0ZTEhMB8GA1UEChMYSW50\nZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB\nCgKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmGdtcGbg/1\nCGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKnabIRuGvB\nKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpidtnKX/a+5\n0GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+pyFxIXjbEI\ndZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pEewooaeO2\nizNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABo4GnMIGkMB0GA1UdDgQWBBT/LbE4\n9rWf288N6sJA5BRb6FJIGDB1BgNVHSMEbjBsgBT/LbE49rWf288N6sJA5BRb6FJI\nGKFJpEcwRTELMAkGA1UEBhMCQVUxEzARBgNVBAgTClNvbWUtU3RhdGUxITAfBgNV\nBAoTGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZIIJAMHAwfXZ5/PWMAwGA1UdEwQF\nMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAHHFwl0tH0quUYZYO0dZYt4R7SJ0pCm2\n2satiyzHl4OnXcHDpekAo7/a09c6Lz6AU83cKy/+x3/djYHXWba7HpEu0dR3ugQP\nMlr4zrhd9xKZ0KZKiYmtJH+ak4OM4L3FbT0owUZPyjLSlhMtJVcoRp5CJsjAMBUG\nSvD8RX+T01wzox/Qb+lnnNnOlaWpqu8eoOenybxKp1a9ULzIVvN/LAcc+14vioFq\n2swRWtmocBAs8QR9n4uvbpiYvS8eYueDCWMM4fvFfBhaDZ3N9IbtySh3SpFdQDhw\nYbjM2rxXiyLGxB4Bol7QTv4zHif7Zt89FReT/NBy4rzaskDJY5L6xmY=\n-----END CERTIFICATE-----\n", "private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmG\ndtcGbg/1CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKn\nabIRuGvBKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpid\ntnKX/a+50GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+py\nFxIXjbEIdZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pE\newooaeO2izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABAoIBACbhTYXBZYKmYPCb\nHBR1IBlCQA2nLGf0qRuJNJZg5iEzXows/6tc8YymZkQE7nolapWsQ+upk2y5Xdp/\naxiuprIs9JzkYK8Ox0r+dlwCG1kSW+UAbX0bQ/qUqlsTvU6muVuMP8vZYHxJ3wmb\n+ufRBKztPTQ/rYWaYQcgC0RWI20HTFBMxlTAyNxYNWzX7RKFkGVVyB9RsAtmcc8g\n+j4OdosbfNoJPS0HeIfNpAznDfHKdxDk2Yc1tV6RHBrC1ynyLE9+TaflIAdo2MVv\nKLMLq51GqYKtgJFIlBRPQqKoyXdz3fGvXrTkf/WY9QNq0J1Vk5ERePZ54mN8iZB7\n9lwy/AkCgYEA6FXzosxswaJ2wQLeoYc7ceaweX/SwTvxHgXzRyJIIT0eJWgx13Wo\n/WA3Iziimsjf6qE+SI/8laxPp2A86VMaIt3Z3mJN/CqSVGw8LK2AQst+OwdPyDMu\niacE8lj/IFGC8mwNUAb9CzGU3JpU4PxxGFjS/eMtGeRXCWkK4NE+G08CgYEA1Kp9\nN2JrVlqUz+gAX+LPmE9OEMAS9WQSQsfCHGogIFDGGcNf7+uwBM7GAaSJIP01zcoe\nVAgWdzXCv3FLhsaZoJ6RyLOLay5phbu1iaTr4UNYm5WtYTzMzqh8l1+MFFDl9xDB\nvULuCIIrglM5MeS/qnSg1uMoH2oVPj9TVst/ir8CgYEAxrI7Ws9Zc4Bt70N1As+U\nlySjaEVZCMkqvHJ6TCuVZFfQoE0r0whdLdRLU2PsLFP+q7qaeZQqgBaNSKeVcDYR\n9B+nY/jOmQoPewPVsp/vQTCnE/R81spu0mp0YI6cIheT1Z9zAy322svcc43JaWB7\nmEbeqyLOP4Z4qSOcmghZBSECgYACvR9Xs0DGn+wCsW4vze/2ei77MD4OQvepPIFX\ndFZtlBy5ADcgE9z0cuVB6CiL8DbdK5kwY9pGNr8HUCI03iHkW6Zs+0L0YmihfEVe\nPG19PSzK9CaDdhD9KFZSbLyVFmWfxOt50H7YRTTiPMgjyFpfi5j2q348yVT0tEQS\nfhRqaQKBgAcWPokmJ7EbYQGeMbS7HC8eWO/RyamlnSffdCdSc7ue3zdVJxpAkQ8W\nqu80pEIF6raIQfAf8MXiiZ7auFOSnHQTXUbhCpvDLKi0Mwq3G8Pl07l+2s6dQG6T\nlv6XTQaMyf6n1yjzL+fzDrH3qXMxHMO/b13EePXpDMpY7HQpoLDi\n-----END RSA PRIVATE KEY-----\n", "bundle_method": "compatible"}' -i "cis-demo"

ibmcloud cis certificate-priority-change

DNS ドメインのカスタム証明書の優先順位を変更する。

ibmcloud cis certificate-priority-change DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]
[Deprecated] ibmcloud cis certificate-priority-change DNS_DOMAIN_ID (-s, --json-str JSON_STR | -j, --json-file JSON_FILE) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--json
カスタム証明書の優先順位を記述するために使用される JSON ファイルまたは JSON 文字列。 必須。
  • JSON データ内の必須フィールドは certificates です。
    • certificates: 以下のフィールドを持つオブジェクトの配列。
      • id: カスタム証明書 ID。
      • priority: リクエストにおいて証明書が使用される順序または優先順位。 番号が高い順に試行されます。

サンプル JSON データ:

{
"certificates":[
   {
      "id":"5a7805061c76ada191ed06f989cc3dac",
      "priority":2
   },
   {
      "id":"da534493b38266b17fea74f3312be21c",
   "priority":1
   }
]
}
-s, --json-str
非推奨。 カスタム証明書の優先度を変更するために使用される JSON データ。
-j, --json-file
非推奨。 ファイルは入力 JSON データを含みます。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのカスタム証明書の優先順位を変更する。

ibmcloud cis certificate-priority-change DNS_DOMAIN_ID --json '{"certificates": [{"id":"5a7805061c76ada191ed06f989cc3dac", "priority":2},{"id":"9a7806061c88ada191ed06f989cc3dac","priority":1}]}'

ibmcloud cis certificate-delete

専用またはカスタムの証明書を削除します。

ibmcloud cis certificate-delete DNS_DOMAIN_ID CERT_ID [--keyless][-i, --instance INSTANCE]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
CERT_ID
専用またはカスタム証明書のID。 必須。
--keyless
キーレス証明書を削除します。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

例

カスタム証明書を削除します。

ibmcloud cis certificate-delete DNS_DOMAIN_ID CERT_ID

Web アプリケーション・ファイアウォール (WAF)

以下の waf コマンドを使用して、Web アプリケーション・ファイアウォールを管理します。

ibmcloud cis waf-setting

WAF 設定を表示します。

ibmcloud cis waf-setting DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのWAF設定を表示します。

ibmcloud cis waf-setting DNS_DOMAIN_ID

ibmcloud cis waf-setting-update

WAFの設定を更新する。

ibmcloud cis waf-setting-update DNS_DOMAIN_ID WAF_MODE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
WAF_MODE
WAFの設定方法。 有効な値は waf-enable および waf-disable です。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのWAFを有効にする。

ibmcloud cis waf-setting-update DNS_DOMAIN_ID waf-enable

ibmcloud cis waf-packages

すべての WAF パッケージをリストします。

ibmcloud cis waf-packages DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのすべての WAF パッケージを一覧表示します。

ibmcloud cis waf-packages DNS_DOMAIN_ID

ibmcloud cis waf-package

WAF パッケージの詳細を取得します。

ibmcloud cis waf-package DNS_DOMAIN_ID WAF_PACKAGE_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
WAF_PACKAGE_ID
WAFパッケージのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

WAF パッケージの詳細を取得します。

ibmcloud cis waf-package DNS_DOMAIN_ID WAF_PACKAGE_ID

ibmcloud cis waf-package-set

OWASP パッケージ設定を更新します。

ibmcloud cis waf-package-set DNS_DOMAIN_ID OWASP_PACKAGE_ID [--sensitivity SENSITIVITY] [--action-mode ACTION_MODE] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
OWASP_PACKAGE_ID
WAFパッケージのID。 必須。
--sensitivity
ファイアウォール・パッケージの機密度。 有効な値は、high、medium、low、およびoffです。
--action-mode
ファイアウォール・パッケージ内のルールに対して行われるデフォルトのアクション。 有効な値は simulate と block, challenge。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

パッケージの OWASP 設定を更新する。

ibmcloud cis waf-package-set DNS_DOMAIN_ID OWASP_PACKAGE_ID --sensitivity medium --action-mode simulate

ibmcloud cis waf-groups

WAF パッケージに含まれる WAF グループを列挙してください。

ibmcloud cis waf-groups DNS_DOMAIN_ID WAF_PACKAGE_ID [--page PAGE] [--per-page NUM] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
WAF_PACKAGE_ID
WAFパッケージのID。 必須。
--page
ページ分割された検索結果のページ番号。 デフォルト値は 1です。
--per-page
1ページあたりのグループ数。 最小値は 5 、最大値は です 1000。 デフォルト値は50です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

WAF パッケージに含まれる WAF グループを列挙してください。

ibmcloud cis waf-groups DNS_DOMAIN_ID WAF_PACKAGE_ID --page 1 --per-page 100

ibmcloud cis waf-group

WAF グループの詳細を取得します。

ibmcloud cis waf-group DNS_DOMAIN_ID WAF_PACKAGE_ID WAF_GROUP_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
WAF_PACKAGE_ID
WAFパッケージのID。 必須。
WAF_GROUP_ID
WAFグループのID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

WAF パッケージ内の WAF グループの詳細を確認する。

ibmcloud cis waf-group DNS_DOMAIN_ID WAF_PACKAGE_ID WAF_GROUP_ID

ibmcloud cis waf-group-mode-set

WAFグループのモードを設定します。

ibmcloud cis waf-group-mode-set DNS_DOMAIN_ID WAF_PACKAGE_ID WAF_GROUP_ID WAF_GROUP_MODE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
WAF_PACKAGE_ID
WAFパッケージのID。 必須。
WAF_GROUP_ID
WAFグループのID。 必須。
WAF_GROUP_MODE
WAFグループの動作モード。 有効な値は on および off です。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

WAFパッケージのWAFグループを有効にする。

ibmcloud cis waf-group-mode-set DNS_DOMAIN_ID WAF_PACKAGE_ID WAF_GROUP_ID on

ibmcloud cis waf-rules

WAF パッケージのすべての WAF ルールをリストします。

ibmcloud cis waf-rules DNS_DOMAIN_ID WAF_PACKAGE_ID [--page PAGE] [--per-page NUM] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
WAF_PACKAGE_ID
WAFパッケージのID。 必須。
--page
ページ番号が割り当てられた検索結果のページ番号。 デフォルト値は 1です。
--per-page
ページあたりのルールの数。 デフォルト値は 50です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

WAF パッケージに含まれるすべての WAF ルールを一覧表示します。

ibmcloud cis waf-rules DNS_DOMAIN_ID WAF_PACKAGE_ID --page 1 --per-page 100

ibmcloud cis waf-rule

WAF ルールの詳細を取得します。

ibmcloud cis waf-rule DNS_DOMAIN_ID WAF_PACKAGE_ID WAF_RULE_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
WAF_PACKAGE_ID
WAF パッケージの ID。 必須。
WAF_RULE_ID
WAFルールのID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

WAF パッケージ内の WAF ルールの詳細を確認する。

ibmcloud cis waf-rule DNS_DOMAIN_ID WAF_PACKAGE_ID WAF_RULE_ID

ibmcloud cis waf-rule-mode-set

WAFルールのモードを設定します。

ibmcloud cis waf-rule-mode-set DNS_DOMAIN_ID WAF_PACKAGE_ID WAF_RULE_ID WAF_RULE_MODE [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
WAF_PACKAGE_ID
WAFパッケージのID。 必須。
WAF_RULE_ID
WAFルールのID。 必須。
WAF_RULE_MODE
WAFルールのモード。 有効な値は on、 off、 default、 disable、、 simulate、 block、 および です challenge。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

WAF パッケージ内の WAF ルールを無効にします。

ibmcloud cis waf-rule-mode-set DNS_DOMAIN_ID WAF_PACKAGE_ID WAF_RULE_ID disable

ibmcloud cis cis waf-override-create

URL ベースの Web アプリケーションファイアウォール(WAF)ルールを作成します。

ibmcloud cis waf-override-create DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
--json
オーバーライド WAF ルールを記述するために使用される JSON ファイルまたは JSON 文字列。 必須。
  • JSON データにおける必須フィールドは urls および です rules。
    • urls: このルール定義に含めるURL。 ワイルドカードを使用できます。
    • rules: WAFルールに割り当てられているアクションを変更します。 このオブジェクトのキーは WAF ルール ID であり、値は有効な WAF アクションである必要があります。 このルールを無効にしない場合は、この WAF ルールが属するルール・グループも必ず有効にしてください。 最大文字数は です 1024。
  • オプションのフィールドは paused、 description、 priority、 groups、、 です rewrite_action。
    • paused: このパッケージが現在一時停止中かどうか。 有効な値は true と false。
    • description: このルールの目的を説明するために使用できる注記。
    • priority: 1つの URL に対して複数の構成が一致する場合の、この構成の相対的な優先順位。 優先順位の高い設定は、優先順位の低い設定で指定された値を上書きする場合があります。 最小値は -1000000000 、最大値は 1000000000。
    • groups WAF ルール・グループを有効または無効にします。 このオブジェクトのキーは WAF ルール ID であり、値は有効な WAF アクションである必要があります (通常はdefault または disable)。
    • rewrite_action: WAFルールが一致した場合、そのルールに設定されたアクションを、このオブジェクトで指定された別のアクションに置き換えます。

サンプル JSON データ:

   {
      "description": "Enable IBM Magento ruleset for www.example.com",
      "urls": [
         "www.example.com/*"
      ],
      "priority": 1,
      "groups": {
         "ea8687e59929c1fd05ba97574ad43f77": "default"
      },
      "rules": {
         "100015": "disable"
      },
      "rewrite_action": {
         "default": "block",
         "challenge": "block",
         "simulate": "disable"
      }
   }
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

WAFオーバーライドルールを作成する。

ibmcloud cis waf-override-create DNS_DOMAIN_ID --json '{"description":"Enable IBM Magento ruleset for www.example.com","urls":["www.example.com/*"],"priority":1,"groups":{"ea8687e59929c1fd05ba97574ad43f77":"default"},"rules":{"100015":"disable"},"rewrite_action":{"default":"block","challenge":"block","simulate":"disable"}}'

ibmcloud cis cis waf-override-update

URL ベースの Web アプリケーションファイアウォール(WAF)ルールを更新します。

ibmcloud cis waf-override-update DNS_DOMAIN_ID OVERRIDE_WAF_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID
DNSドメインのID。 必須。
OVERRIDE_WAF_ID
オーバーライド WAF ルールの ID。 必須。
--json
WAFルールのオーバーライドを記述するために使用されるJSONファイルまたはJSON文字列。 必須。
  • JSON データにおける必須フィールドは urls および です rules。
    • urls: このルール定義に含めるURL。 ワイルドカードを使用できます。
    • rules: WAFルールに割り当てられているアクションを変更します。 このオブジェクトのキーは WAF ルール ID であり、値は有効な WAF アクションである必要があります。 このルールを無効にしない限り、このWAFルールが属するルールグループも有効にしてください。 最大文字数は です 1024。
  • オプションのフィールドは paused、 description、 priority、 groups、、 です rewrite_action。
    • paused: このパッケージが現在一時停止中かどうか。 有効な値は true と false。
    • description: このルールの目的を説明するために使用できる注記。
    • priority: 1つの URL に対して複数の構成が一致する場合の、この構成の相対的な優先順位。 優先順位の高い設定は、優先順位の低い設定で指定された値を上書きする場合があります。 最小値は -1000000000 、最大値は 1000000000。
    • groups WAF ルール・グループを有効または無効にします。 このオブジェクトのキーは WAF ルール ID であり、値は有効な WAF アクションである必要があります (通常はdefault または disable)。
    • rewrite_action: WAFルールが一致した場合、そのルールに設定されたアクションを、このオブジェクトで指定された別のアクションに置き換えます。

サンプル JSON データ:

{
   "description": "Enable IBM Magento ruleset for www.example.com",
   "urls": [
      "www.example.com/*"
   ],
   "priority": 1,
   "groups": {
      "ea8687e59929c1fd05ba97574ad43f77": "default"
   },
   "rules": {
      "100015": "disable"
   },
   "rewrite_action": {
      "default": "block",
      "challenge": "block",
      "simulate": "disable"
   }
}
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

WAFのオーバーライドルールを更新します。

ibmcloud cis waf-override-update DNS_DOMAIN_ID OVERRIDE_WAF_ID --json '{"description":"Enable IBM Magento ruleset for www.example.com","urls":["www.example.com/*"],"priority":1,"groups":{"ea8687e59929c1fd05ba97574ad43f77":"default"},"rules":{"100015":"disable"},"rewrite_action":{"default":"block","challenge":"block","simulate":"disable"}}'

ibmcloud cis cis waf-overrides

URL ベースの Web アプリケーションファイアウォール(WAF)ルールをすべて一覧表示します。

ibmcloud cis waf-overrides DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--page
ページ番号付けした結果のページ番号。 デフォルト値は 1です。
--per-page
ページあたりのルールの数。 デフォルト値は 50です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

WAFオーバーライドルールをリストアップする。

ibmcloud cis waf-overrides DNS_DOMAIN_ID

ibmcloud cis cis waf-override

URL ベースの Web アプリケーションファイアウォール(WAF)ルールを取得します。

ibmcloud cis waf-override DNS_DOMAIN_ID OVERRIDE_WAF_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

OVERRIDE_WAF_ID
WAFルールのオーバーライドID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

WAFオーバーライドルールを取得する。

ibmcloud cis waf-override DNS_DOMAIN_ID OVERRIDE_WAF_ID

ibmcloud cis cis waf-override-delete

URL ベースの Web アプリケーションファイアウォール (WAF) ルールを削除します。

ibmcloud cis waf-override-delete DNS_DOMAIN_ID OVERRIDE_WAF_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

OVERRIDE_WAF_ID
WAFルールのオーバーライドID。 必須。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
-f, --force
確認のメッセージを表示せずに、 URL ベースの WAF ルールを削除しようとしました。

例

WAFオーバーライドルールを削除します。

ibmcloud cis waf-override-delete DNS_DOMAIN_ID OVERRIDE_WAF_ID

認証済み Origin Pull

以下の authenticated-origin-pull コマンドを使用して、認証済み Origin Pull を管理します。

ibmcloud cis authenticated-origin-pull-settings

ドメインの認証済み Origin Pull 設定を取得します。

ibmcloud cis authenticated-origin-pull-settings DNS_DOMAIN_ID [--level zone|hostname] [--hostname HOSTNAME] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

----level
ゾーン・レベルまたはホスト名レベルで、認証済み Origin Pull 証明書または設定を指定します。 有効な値は zone および hostname です。 デフォルト値はzoneです。
--hostname
ホスト名における認証済みオリジンのプル設定。(ホスト名レベルのみ)
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのゾーンレベルにおける、認証済みオリジンのプル設定を一覧表示します。

ibmcloud cis authenticated-origin-pull-settings DNS_DOMAIN_ID

ibmcloud cis authenticated-origin-pull-setting-update

ドメインの認証済み Origin Pull 設定を更新します。

ibmcloud cis authenticated-origin-pull-settings-update DNS_DOMAIN_ID [--level zone|hostname] [--hostname HOSTNAME] [--cert_id CERT_ID] (--enabled on|off) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

----level
ゾーン・レベルまたはホスト名レベルで、認証済み Origin Pull 証明書または設定を指定します。 有効な値は zone および hostname です。 デフォルト値はzoneです。
--hostname
ホスト名における認証済みオリジンのプル設定。(ホスト名レベルのみ)
----cert_id
ホスト名が紐付けられている証明書 ID。(ホスト名レベルのみ)
----enabled
認証済みオリジンプルを有効にする。 有効な値は on および off です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのゾーンレベルで、認証済みオリジンのプル設定を更新します。

ibmcloud cis authenticated-origin-pull-settings-update DNS_DOMAIN_ID --enabled on

ibmcloud cis authenticated-origin-pull-certificates

ドメインのゾーンレベルの認証済みオリジン・プル証明書を一覧表示します。

ibmcloud cis authenticated-origin-pull-certificates DNS_DOMAIN_ID [--level zone|hostname][-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

----level
ゾーン・レベルまたはホスト名レベルで、認証済み Origin Pull 証明書または設定を指定します。 有効な値は zone および hostname です。 デフォルト値はzoneです。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのゾーンレベルで、認証済みオリジン・プル証明書を表示する。

ibmcloud cis authenticated-origin-pull-certificates DNS_DOMAIN_ID

ibmcloud cis authenticated-origin-pull-certificate

ドメインの認証済みオリジン・プル証明書を取得します。

ibmcloud cis authenticated-origin-pull-certificate DNS_DOMAIN_ID CERT_ID [--level zone|hostname] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

CERT_ID
証明書のID。 必須。
----level
ゾーン・レベルまたはホスト名レベルで、認証済み Origin Pull 証明書または設定を指定します。 有効な値は zone および hostname です。 デフォルト値はzoneです。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインに対して、ゾーンレベルで認証済みオリジンプル証明書を取得します。

ibmcloud cis authenticated-origin-pull-certificate DNS_DOMAIN_ID CERT_ID

ibmcloud cis authenticated-origin-pull-certificate-upload

ドメインの認証済みオリジン・プル証明書をアップロードします。

ibmcloud cis authenticated-origin-pull-certificate-upload DNS_DOMAIN_ID [--level zone|hostname] (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

--level
ゾーン・レベルまたはホスト名レベルで、認証済み Origin Pull 証明書または設定を指定します。 有効な値は zone および hostname です。 デフォルト値はzoneです。
--json
カスタム証明書を記述するために使用されるJSONファイルまたはJSON文字列。
  • JSON データにおける必須フィールドは certificate および です: private_key
  • certificate :当該ドメイン用の SSL 証明書、または証明書と1つ以上の中間証明書。
  • private_key: ドメインの秘密鍵。

サンプル JSON データ:

{
  "certificate": "-----BEGIN CERTIFICATE-----\n...-----END CERTIFICATE-----\n",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...-----END PRIVATE KEY-----\n"
}
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインに対して、ゾーンレベルで認証済みのオリジンプル証明書をアップロードします。

ibmcloud cis authenticated-origin-pull-certificate-upload DNS_DOMAIN_ID --json '{"certificate": "-----BEGIN CERTIFICATE-----\nMIIDtTCCAp2gAwIBAgIJAMHAwfXZ5/PWMA0GCSqGSIb3DQEBCwUAMEUxCzAJBgNV\nBAYTAkFVMRMwEQYDVQQIEwpTb21lLVN0YXRlMSEwHwYDVQQKExhJbnRlcm5ldCBX\naWRnaXRzIFB0eSBMdGQwHhcNMTYwODI0MTY0MzAxWhcNMTYxMTIyMTY0MzAxWjBF\nMQswCQYDVQQGEwJBVTETMBEGA1UECBMKU29tZS1TdGF0ZTEhMB8GA1UEChMYSW50\nZXJuZXQgV2lkZ2l0cyBQdHkgTHRkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB\nCgKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmGdtcGbg/1\nCGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKnabIRuGvB\nKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpidtnKX/a+5\n0GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+pyFxIXjbEI\ndZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pEewooaeO2\nizNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABo4GnMIGkMB0GA1UdDgQWBBT/LbE4\n9rWf288N6sJA5BRb6FJIGDB1BgNVHSMEbjBsgBT/LbE49rWf288N6sJA5BRb6FJI\nGKFJpEcwRTELMAkGA1UEBhMCQVUxEzARBgNVBAgTClNvbWUtU3RhdGUxITAfBgNV\nBAoTGEludGVybmV0IFdpZGdpdHMgUHR5IEx0ZIIJAMHAwfXZ5/PWMAwGA1UdEwQF\nMAMBAf8wDQYJKoZIhvcNAQELBQADggEBAHHFwl0tH0quUYZYO0dZYt4R7SJ0pCm2\n2satiyzHl4OnXcHDpekAo7/a09c6Lz6AU83cKy/+x3/djYHXWba7HpEu0dR3ugQP\nMlr4zrhd9xKZ0KZKiYmtJH+ak4OM4L3FbT0owUZPyjLSlhMtJVcoRp5CJsjAMBUG\nSvD8RX+T01wzox/Qb+lnnNnOlaWpqu8eoOenybxKp1a9ULzIVvN/LAcc+14vioFq\n2swRWtmocBAs8QR9n4uvbpiYvS8eYueDCWMM4fvFfBhaDZ3N9IbtySh3SpFdQDhw\nYbjM2rxXiyLGxB4Bol7QTv4zHif7Zt89FReT/NBy4rzaskDJY5L6xmY=\n-----END CERTIFICATE-----\n", "private_key": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmG\ndtcGbg/1CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKn\nabIRuGvBKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpid\ntnKX/a+50GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+py\nFxIXjbEIdZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pE\ewooaeO2izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABAoIBACbhTYXBZYKmYPCb\nHBR1IBlCQA2nLGf0qRuJNJZg5iEzXows/6tc8YymZkQE7nolapWsQ+upk2y5Xdp/\naxiuprIs9JzkYK8Ox0r+dlwCG1kSW+UAbX0bQ/qUqlsTvU6muVuMP8vZYHxJ3wmb\n+ufRBKztPTQ/rYWaYQcgC0RWI20HTFBMxlTAyNxYNWzX7RKFkGVVyB9RsAtmcc8g\n+j4OdosbfNoJPS0HeIfNpAznDfHKdxDk2Yc1tV6RHBrC1ynyLE9+TaflIAdo2MVv\nKLMLq51GqYKtgJFIlBRPQqKoyXdz3fGvXrTkf/WY9QNq0J1Vk5ERePZ54mN8iZB7\n9lwy/AkCgYEA6FXzosxswaJ2wQLeoYc7ceaweX/SwTvxHgXzRyJIIT0eJWgx13Wo\n/WA3Iziimsjf6qE+SI/8laxPp2A86VMaIt3Z3mJN/CqSVGw8LK2AQst+OwdPyDMu\niacE8lj/IFGC8mwNUAb9CzGU3JpU4PxxGFjS/eMtGeRXCWkK4NE+G08CgYEA1Kp9\nN2JrVlqUz+gAX+LPmE9OEMAS9WQSQsfCHGogIFDGGcNf7+uwBM7GAaSJIP01zcoe\nVAgWdzXCv3FLhsaZoJ6RyLOLay5phbu1iaTr4UNYm5WtYTzMzqh8l1+MFFDl9xDB\nvULuCIIrglM5MeS/qnSg1uMoH2oVPj9TVst/ir8CgYEAxrI7Ws9Zc4Bt70N1As+U\nlySjaEVZCMkqvHJ6TCuVZFfQoE0r0whdLdRLU2PsLFP+q7qaeZQqgBaNSKeVcDYR\n9B+nY/jOmQoPewPVsp/vQTCnE/R81spu0mp0YI6cIheT1Z9zAy322svcc43JaWB7\nmEbeqyLOP4Z4qSOcmghZBSECgYACvR9Xs0DGn+wCsW4vze/2ei77MD4OQvepPIFX\ndFZtlBy5ADcgE9z0cuVB6CiL8DbdK5kwY9pGNr8HUCI03iHkW6Zs+0L0YmihfEVe\nPG19PSzK9CaDdhD9KFZSbLyVFmWfxOt50H7YRTTiPMgjyFpfi5j2q348yVT0tEQS\nfhRqaQKBgAcWPokmJ7EbYQGeMbS7HC8eWO/RyamlnSffdCdSc7ue3zdVJxpAkQ8W\nqu80pEIF6raIQfAf8MXiiZ7auFOSnHQTXUbhCpvDLKi0Mwq3G8Pl07l+2s6dQG6T\nlv6XTQaMyf6n1yjzL+fzDrH3qXMxHMO/b13EePXpDMpY7HQpoLDi\n-----END RSA PRIVATE KEY-----\n"}'

ibmcloud cis authenticated-origin-pull-certificate-delete

ドメインの認証済みオリジン・プル証明書を削除します。

ibmcloud cis authenticated-origin-pull-certificate-delete DNS_DOMAIN_ID CERT_ID [--level zone|hostname] [-i, --instance INSTANCE] [--output FORMAT] [-f, --force]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。 必須。

CERT_ID
証明書のID。 必須。
--level
ゾーン・レベルまたはホスト名レベルで、認証済み Origin Pull 証明書または設定を指定します。 有効な値は zone および hostname です。 デフォルト値はzoneです。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのゾーンレベルで、認証済みオリジンのプル証明書を削除します。

ibmcloud cis authenticated-origin-pull-certificate-delete DNS_DOMAIN_ID CERT_ID

アラート・ポリシー

アラート・ポリシーを管理します。

ibmcloud cis alert-policy list (リスト)

すべてのアラート・ポリシーをリストします。

ibmcloud cis alert-policy list [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンスに関するすべてのポリシーを列挙する。

ibmcloud cis alert-policy list

ibmcloud cis alert-policy get (表示)

ポリシーの詳細を表示します。

ibmcloud cis alert-policy get POLICY_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

アラートポリシーの詳細を表示します。

ibmcloud cis alert-policy get POLICY_ID

ibmcloud cis alert-policy ddos-attack-l7-alert-create

DDos 攻撃 l7 に対するアラート・ポリシーを作成します。

ibmcloud cis alert-policy ddos-attack-l7-alert-create --name NAME (--emails EMAILS | --webhooks WEBHOOKS) --enabled (true | false) [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--name

アラート・ポリシーの名前。

--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

DDoS 攻撃アラートポリシーを作成します。

ibmcloud cis alert-policy ddos-attack-l7-alert-create --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --enabled true --instance INSTANCE

ibmcloud cis alert-policy ddos-attack-l3-l4-alert-create

DDos アタック L3/L4 のアラート・ポリシーを作成します。

ibmcloud cis alert-policy ddos-attack-l3-l4-alert-create --name NAME (--emails EMAILS | --webhooks WEBHOOKS) --enabled (true | false) [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--name

アラート・ポリシーの名前。

--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

DDoS L3/L4 攻撃アラートポリシーを作成する。

ibmcloud cis alert-policy ddos-attack-l3-l4-alert-create --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --enabled true --instance INSTANCE

ibmcloud cis alert-policy failing-logpush-job-alert-create

過去24時間に、logpushジョブが少なくとも1回のプッシュを正常に完了しなかった場合に、アラートポリシーを作成します。

ibmcloud cis alert-policy failing-logpush-job-alert-create --name NAME (--emails EMAILS | --webhooks WEBHOOKS) --enabled (true | false) [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--name

アラート・ポリシーの名前。

--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

失敗したlogpushジョブ無効アラートポリシーを作成します。

ibmcloud cis alert-policy failing-logpush-job-alert-create --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --enabled true --instance INSTANCE

ibmcloud cis alert-policy pool-toggle-alert-create (プール・トグル・アラート)

プール・トグル・アラートのアラート・ポリシーを作成します。

ibmcloud cis alert-policy pool-toggle-alert-create --name NAME (--emails EMAILS | --webhooks WEBHOOKS) --enabled (true | false) --pools POOLS --trigger-condition (enabled | disabled | either) [--include-future-pools (true | false)] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--name

アラート・ポリシーの名前。

--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
--pools
オリジンプールのID。すべてに設定されている場合、すべてのプールのIDが使用されます。
--trigger-condition
プールのトグルステータスの状態。
--include-future-pools
将来プールを含めるかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

プール・トグル・アラート・ポリシーを作成します。

ibmcloud cis alert-policy pool-toggle-alert-create --name test1 --emails test1@cn.ibm.com --enabled true --pools all --trigger-condition enabled --include-future-pools true --instance INSTANCE

ibmcloud cis alert-policy firewall-events-alert-create

ファイアウォール・イベントのスパイクに関するアラート・ポリシーを作成します。 ファイアウォールイベントのアラートでは、過去6時間分のイベントを5分単位のバケットに分けて、 https://en.m.wikipedia.org/wiki/Standard_score [z-score] に基づく{: external} 計算が行われます。 Zスコアがしきい値 3.5 よりも大きくなると、警告が発せられる。 同じ 2 時間の時間フレーム内に重複するアラートを受け取ることはありません。

ibmcloud cis alert-policy firewall-events-alert-create --name NAME (--emails EMAILS | --webhooks WEBHOOKS) --enabled (true | false) --domains DOMAINS [--services SERVICES] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--name

アラート・ポリシーの名前。

--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
--domains
アラートポリシーに指定されたドメイン ID。 例: --domains domainID1,domainID2
--services
アラートがモニターするサービスを指定します。 有効な値は、 country-access-rules、 waf、 firewall-rules、 ratelimit、 securitylevel、 ip-access-rules、 browser-integrity-check、 ua-rules、 lockdowns、 iprange-access-rules、 asn-access-rules、 Managed-firewall Enterprise Plans Only
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ファイアウォール・イベント・アラートを作成する。

ibmcloud cis alert-policy firewall-events-alert-create --name test1 --emails test1@cn.ibm.com --enabled true --domains d2633e61-1b61-2512-1321-b61a17c3db7e --services waf,ratelimit --instance INSTANCE

ibmcloud cis alert-policy certificate-alert-create

証明書イベントのアラート・ポリシーを作成します。

ibmcloud cis alert-policy certificate-alert-create --type (universal | dedicated | mtls ) --name NAME (--emails EMAILS | --webhooks WEBHOOKS) --enabled (true | false) [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--type

証明書の種類。

--name
アラート・ポリシーの名前。
--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

証明書アラートを作成する。

ibmcloud cis alert-policy certificate-alert-create --type universal --name test1 --emails test1@cn.ibm.com --enabled true --instance INSTANCE

ibmcloud cis alert-policy glb-healthcheck-alert-create

グローバル・ロード・バランサー、プール、および起点の正常性状況の変更に対するアラート・ポリシーを作成します。

ibmcloud cis alert-policy glb-healthcheck-alert-create --name NAME (--emails EMAILS | --webhooks WEBHOOKS) --enabled (true | false) --pools POOLS [--include-future-pools (true | false)] [--health-status-trigger (healthy | unhealthy | either)] [--event-source-trigger (pool | origin | either)] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--name

アラート・ポリシーの名前。

--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
--pools
オリジンプールのID。 に設定すると all、すべてのプール ID が使用されます。
--include-future-pools
将来プールを含めるかどうか。 (デフォルト値は false)
--health-status-trigger
通知を起動するトリガーの条件。 有効な値は healthy、 unhealthy、 either。 (デフォルト値は either)
--event-source-trigger
通知を起動するトリガーのイベント・ソース。 有効な値は pool、 origin、 either。 (デフォルト値は either)
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

glbヘルスチェック警告ポリシーを作成する。

ibmcloud cis alert-policy glb-healthcheck-alert-create --name test1 --emails test1@cn.ibm.com --enabled true --pools all --include-future-pools true --instance INSTANCE

ibmcloud cis alert-policy web-analytics-alert-create

Web メトリクス レポートのアラート ポリシーを作成します。

ibmcloud cis alert-policy web-analytics-alert-create --name NAME (--emails EMAILS | --webhooks WEBHOOKS) --enabled (true | false) [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--name

アラート・ポリシーの名前。

--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

Web メトリクス・レポートのアラート・ポリシーを作成します。

ibmcloud cis alert-policy web-analytics-alert-create --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --enabled true --instance INSTANCE

ibmcloud cis alert-policy maintenance-event-alert-create

メンテナンスイベント用のアラートポリシーを作成します。

ibmcloud cis alert-policy maintenance-event-alert-create --name NAME (--emails EMAILS | --webhooks WEBHOOKS) --enabled (true | false) --event-type TYPE [--airport-code AIRPORT_CODE] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--name

アラート・ポリシーの名前。

--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
--event-type
メンテナンス・イベントのタイプ。 有効な値は scheduled、 changed、 canceled。
--airport-code
コンマで区切られたの 3 文字の IATA コード。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

メンテナンスイベント警告ポリシーを作成します。

ibmcloud cis alert-policy maintenance-event-alert-create --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --event-type scheduled,changed,canceled --airport-code IAD,AUS --enabled true

ibmcloud cis alert-policy ddos-attack-l7-alert-update

DDos 攻撃 l7のアラート・ポリシーを更新します。

ibmcloud cis alert-policy ddos-attack-l7-alert-update POLICY_ID [--name NAME] [--emails EMAILS] [--webhooks WEBHOOKS] [--enabled (true | false)] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

--name
アラート・ポリシーの名前。
--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

DDoS 攻撃アラートポリシーを更新する。

ibmcloud cis alert-policy ddos-attack-l7-alert-update POLICY_ID --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --enabled true

ibmcloud cis alert-policy ddos-attack-l3-l4-alert-update

DDos 攻撃 L3/L4 のアラート・ポリシーを更新します。

ibmcloud cis alert-policy ddos-attack-l3-l4-alert-update POLICY_ID [--name NAME] [--emails EMAILS] [--webhooks WEBHOOKS] [--enabled (true | false)] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

--name
アラート・ポリシーの名前。
--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

DDoS 攻撃アラートポリシーを更新する。

ibmcloud cis alert-policy ddos-attack-l3-l4-alert-update POLICY_ID --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --enabled true

ibmcloud cis alert-policy failing-logpush-job-alert-update

過去24時間にlogpushジョブが少なくとも1回のプッシュを正常に完了しなかった場合、アラートポリシーを更新します。

ibmcloud cis alert-policy failing-logpush-job-alert-update POLICY_ID [--name NAME] [--emails EMAILS] [--webhooks WEBHOOKS] [--enabled (true | false)] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

--name
アラート・ポリシーの名前。
--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

失敗したlogpushジョブの警告ポリシーを更新する。

ibmcloud cis alert-policy failing-logpush-job-alert-update POLICY_ID --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --enabled true

ibmcloud cis alert-policy pool-toggle-alert-update

プール・トグル・アラートのアラート・ポリシーを更新します。

ibmcloud cis alert-policy pool-toggle-alert-update POLICY_ID --name NAME (--emails EMAILS | --webhooks WEBHOOKS) --enabled (true | false) --pools POOLS --trigger-condition (enabled | disabled | either) [--include-future-pools (true | false)] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

--name
アラート・ポリシーの名前。
--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
--pools
オリジンプールのID。 に設定すると all、すべてのプール ID が使用されます。
--trigger-condition
プールのトグルステータスの状態。
--include-future-pools
将来プールを含めるかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

プールのトグルアラートポリシーを更新します。

ibmcloud cis alert-policy pool-toggle-alert-update POLICY_ID --name test1 --emails test1@cn.ibm.com --enabled true --pools all --trigger-condition enabled --include-future-pools true

ibmcloud cis alert-policy firewall-events-alert-update

ファイアウォール・イベントのスパイクに関するアラート・ポリシーを更新します。

ibmcloud cis alert-policy firewall-events-alert-update POLICY_ID [--name NAME] [--emails EMAILS] [--webhooks WEBHOOKS] [--enabled (true | false)] [--domains DOMAINS] [--services SERVICES] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

--name
アラート・ポリシーの名前。
--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
--domains
アラートポリシーに指定されたドメイン ID。 例: --domains domainID1,domainID2
--services
アラートが監視すべきサービスを指定してください。 有効な値は、 country-access-rules、 waf、 firewall-rules、 ratelimit、 securitylevel、 ip-access-rules、 browser-integrity-check、 ua-rules、 lockdowns、 iprange-access-rules、 asn-access-rules、 Managed-firewall Enterprise Plans Only

SERVICESは、高度なWAFアラートにのみ使用されます。 更新したいアラートポリシーが、サービスが指定されていない状態で作成されている場合は、更新するのではなく、サービスを指定して新しいポリシーを作成してください。

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ファイアウォール・イベント・アラート・ポリシーを更新する。

ibmcloud cis alert-policy firewall-events-alert-update POLICY_ID --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --enabled true --domains d2633e61-1b61-2512-1321-b61a17c3db7e

ibmcloud cis alert-policy certificate-alert-update

証明書イベントのアラート・ポリシーを更新します。

ibmcloud cis alert-policy certificate-alert-update POLICY_ID [--name NAME] [--emails EMAILS] [--webhooks WEBHOOKS] [--enabled (true | false)] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

--name
アラート・ポリシーの名前。
--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

証明書警告ポリシーを更新する。

ibmcloud cis alert-policy certificate-alert-update POLICY_ID --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --enabled true

ibmcloud cis alert-policy glb-healthcheck-alert-update

グローバル・ロード・バランサー、プール、および起点の正常性状況の変更に対するアラート・ポリシーを更新します。

ibmcloud cis alert-policy glb-healthcheck-alert-update POLICY_ID [--name NAME] [--emails EMAILS] [--webhooks WEBHOOKS] [--enabled (true | false)] [--pools POOLS] [--include-future-pools (true | false)] [--health-status-trigger (healthy | unhealthy | either)] [--event-source-trigger (pool | origin | either)] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

--name
アラート・ポリシーの名前。
--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
--pools
オリジンプールのID。 に設定すると all、すべてのプール ID が使用されます。
--include-future-pools
将来プールを含めるかどうか。 (デフォルト値は false)
--health-status-trigger
通知を送信するトリガー条件。 有効な値は healthy、 unhealthy、 either。 (デフォルト値は either)
--event-source-trigger
通知を送信するためのトリガーのイベントソース。 有効な値は pool、 origin、 either。 (デフォルト値は either)
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

証明書警告ポリシーを更新する。

ibmcloud cis alert-policy glb-healthcheck-alert-update POLICY_ID --name test1 --emails test1@cn.ibm.com --enabled true --pools all --include-future-pools true

ibmcloud cis alert-policy web-analytics-alert-update

Web メトリクス レポートのアラート ポリシーを更新します。

ibmcloud cis alert-policy web-analytics-alert-update POLICY_ID [--name NAME] [--emails EMAILS] [--webhooks WEBHOOKS] [--enabled (true | false)] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

--name
アラート・ポリシーの名前。
--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

Web メトリックレポートのアラートポリシーを更新する。

ibmcloud cis alert-policy web-analytics-alert-update POLICY_ID --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --enabled true

ibmcloud cis alert-policy maintenance-event-alert-update

メンテナンスイベントのアラートポリシーを更新します。

ibmcloud cis alert-policy maintenance-event-alert-update POLICY_ID [--name NAME] [--emails EMAILS] [--webhooks WEBHOOKS] [--enabled (true | false)] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

--name
アラート・ポリシーの名前。
--description
アラート・ポリシーの説明。
--emails
アラート通知を送信するためのメールアドレス。 例: --emails test1@cn.ibm.com,test2@cn.ibm.com
--webhooks
アラート通知を送信するための Webhook ID。 例: --webhook webhookID1,webhookID2
--enabled
アラートポリシーが有効になっているかどうか。
--event-type
メンテナンス・イベントのタイプ。 有効な値は scheduled、 changed、 canceled。
--airport-code
コンマで区切られたの 3 文字の IATA コード。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

メンテナンスイベント警告ポリシーを更新します。

ibmcloud cis alert-policy maintenance-event-alert-update POLICY_ID --name test1 --emails test1@cn.ibm.com --webhooks b2633e68-9a64-4519-b361-a64a67c8db8e --enabled true --event-type scheduled,changed,canceled --airport-code IAD,AUS

ibmcloud cis alert-policy delete

アラート・ポリシーを削除します。

cis alert-policy delete POLICY_ID [-i, --instance INSTANCE] [-f, --force]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
-f, --force
確認のメッセージを表示せずにポリシーを削除しようとしました。

例

アラート・ポリシーを削除します。

ibmcloud cis alert-policy delete POLICY_ID -f

ibmcloud cis alert-policy test

アラート・ポリシーのテスト・アラートを送信します。

cis alert-policy test POLICY_ID [-i, --instance INSTANCE] [-f, --force]

コマンド・オプション

POLICY_ID

アラートポリシーのID。 必須。

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
-f, --force
確認のプロンプトを出さずにテスト・アラートの送信を試行します。

例

アラートポリシーのテスト通知を送信します。

ibmcloud cis alert-policy test POLICY_ID -f

アラート Web フック

ibmcloud cis alert-webhooks

すべてのアラート Webhook をリストします。

ibmcloud cis alert-webhooks [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンスのすべての Webhook を一覧表示します。

ibmcloud cis alert-webhooks

ibmcloud cis alert-webhook

Webhookの詳細を表示します。

ibmcloud cis alert-webhook WEBHOOK_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

WEBHOOK_ID

アラート Webhook の ID。 必須。

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

アラート Webhook の詳細を表示します。

ibmcloud cis alert-webhook WEBHOOK_ID

ibmcloud cis alert-webhook-create

インスタンス用のアラート Webhook を作成します。

ibmcloud cis alert-webhook-create --name NAME --url URL [--secret SECRET] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

--name

Webhook の名前。 必須。

--url
アラートをディスパッチするときに呼び出す POST エンドポイント。 必須。
--secret
Webhook アラートを送信する際に、Webhook 認証ヘッダーで渡されるシークレット。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

アラート Webhook を作成します。

ibmcloud cis alert-webhook-create --name testwebhook --url https://hooks.slack.com/services/Ds3fdBFbV/1234568 --secret 007 --instance INSTANCE

ibmcloud cis alert-webhook-update

アラート Webhook を更新します。

cis alert-webhook-update WEBHOOK_ID [--name NAME] [--url URL] [--secret SECRET] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

WEBHOOK_ID

アラート Webhook の ID。 必須。

--name
Webhook の名前。
--url
アラートをディスパッチするときに呼び出す POST エンドポイント。
--secret
Webhook アラートを送信する際に、Webhook 認証ヘッダーで渡されるシークレット。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

アラート Webhook を更新します。

ibmcloud cis alert-webhook-update WEBHOOK_ID --name testwebhook --url https://hooks.slack.com/services/Ds3fdBFbV/1234568

ibmcloud cis alert-webhook-delete

アラート Webhook を削除します。

ibmcloud cis alert-webhook-delete WEBHOOK_ID [-i, --instance INSTANCE] [-f, --force]

コマンド・オプション

WEBHOOK_ID

アラート Webhook の ID。 必須。

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
-f, --force
確認のメッセージを表示せずに、Webhookの削除を試みる。

例

アラート Webhook を削除します。

ibmcloud cis alert-webhook-delete WEBHOOK_ID -f

高度なレート制限ルール

advanced-rate-limiting コマンドを使用して、高度なレート制限ルールを管理します。

ibmcloud cis advanced-rate-limiting rules

すべての拡張レート制限ルールをリストします。

ibmcloud cis advanced-rate-limiting rules DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインに対するすべての高度なレート制限ルールを一覧表示します。

ibmcloud cis advanced-rate-limiting rules DNS_DOMAIN_ID

ibmcloud cis advanced-rate-limiting rule

高度なレート制限ルールの詳細を確認する。

ibmcloud cis advanced-rate-limiting rule DNS_DOMAIN_ID RULE_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULE_ID
RULE_ID は、高度なレート制限ルールの ID です。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

ドメインのルールを表示する。

ibmcloud cis advanced-rate-limiting rule DNS_DOMAIN_ID RULE_ID

ibmcloud cis advanced-rate-limiting rule-create

拡張レート制限ルールを作成します。

ibmcloud cis advanced-rate-limiting rule-create DNS_DOMAIN_ID --name NAME --match EXPRESSION --action ACTION --same-characteristics CHARACTERSTICS --requests REQUEST_PER_PERIOD --period PERIOD [--timeout TIMEOUT] [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

--name

ルール名。

--match

ルールを実行するために一致する必要がある条件を指定します。 マッチ値については、 フィールド、関数、および式の使用を 参照してください。

--action

ルールで指定されたレートに達した際に実行されるアクション。 有効な値は block、 challenge、 js_challenge、 managed_challenge、 および です log。

--same-characteristics

CIS、ルールのリクエスト率を追跡する方法を定義するパラメータのセット。 1つ以上の特徴を使用してください: ip ip_nat, host, path, country, asnum.複雑な特性の場合は、代わりにJSONファイルまたはJSON文字列を使用する。

--requests

ルールがトリガーされる期間におけるリクエスト数。 有効な値の範囲は 1-1000000

--period

要求レートを評価する際に考慮する期間(秒単位)。 有効な値は、10、60、120、300、600、および3600です。

--timeout

レート制限ルールは、この期間、さらなる要求にルール・アクションを適用します。 有効な値は、 0、 10、 60、 120、 300、 600、 3600、 86400。

--enabled

ルールが有効か無効かを示します。 enabledの有効な値は および true です false。 (デフォルト値は false)

--json

高度なレート制限ルールを記述するために使用される JSON ファイルまたは JSON 文字列。

  • JSON データにおける必須フィールドは expression、 ratelimit 、、 です action。

  • expression: リクエストが高度なレート制限ルールに一致するための基準を定義します。

  • ratelimit: レート制限パラメータを定義します。

  • characteristics CIS がルールのリクエストレートを追跡する方法を定義するパラメー タのセット。

  • requests_per_period: ルールがトリガーされる期間におけるリクエスト数。

  • period: リクエストレートを評価する際に考慮すべき時間(秒単位)。 有効な値は 10、 60、 120、 300、、 600、 および です 3600。

  • requests_to_origin: キャッシュされたアセットにレート制限を適用するかどうか。

  • mitigation_timeout: レート制限ルールは、その期間中に行われるその後のリクエストに対して、ルールアクションを適用します。 有効な値は、 0、 10、 60、 120、 300、 600、 3600、 86400。

  • counting_expression: リクエストレートを決定するために使用される基準を定義します。

  • action: ルールで指定されたレートに達した際に実行されるアクション。 有効な値は block、 challenge、 js_challenge、 managed_challenge、 log。

  • オプションのフィールドは description、 action_parameters、、 です enabled。

  • description: ルールの説明的な名称。

  • action_parameters: アクションのパラメータを定義します。

    • response: ブロック操作に対するカスタム応答を定義します。
    • status_code: レート制限によりリクエストをブロックする際、訪問者に返される HTTP ステータスコードを定義します。 ルール・アクションが「ブロック」の場合にのみ使用可能です。 有効な値の範囲は. から 400-499. までです。 デフォルト値は429です。
    • content_type: レート制限によりリクエストをブロックする際の、カスタム応答のコンテンツタイプを定義します。 ルール・アクションが「ブロック」の場合にのみ使用可能です。
    • content: レート制限によりリクエストがブロックされた場合に返される HTTP レスポンスの本文を定義します。 ルール・アクションが「ブロック」の場合にのみ使用可能です。
  • enabled: このルールを有効にするかどうか。

   Sample JSON data:
      {
         "description": "description",
         "expression": "(http.request.method eq \"POST\")",
         "ratelimit": {
            "characteristics": [
               "cf.unique_visitor_id",
               "cf.colo.id"
            ],
            "requests_to_origin": false,
            "counting_expression": "(ip.src.continent in {\"AN\"})",
            "requests_per_period": 10,
            "period": 10,
            "mitigation_timeout": 120
         },
         "action": "block",
         "action_parameters": {
            "response": {
               "status_code": 429,
               "content_type": "text/xml",
               "content": "reject"
            }
         },
         "enabled": false
      }
-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

31984fea73a15b45779fa0df4ef62f9b のドメインに対して、 cis-demo のインスタンスで高度なレート制限ルールを作成します。

ibmcloud cis advanced-rate-limiting rule-create DNS_DOMAIN_ID --name rule-name --match "(http.request.method eq \"POST\")" --action log --same-characteristics ip,ip_nat --requests 100 --period 10

ibmcloud cis advanced-rate-limiting rule-update

拡張レート制限ルールを更新します。

ibmcloud cis advanced-rate-limiting rule-update DNS_DOMAIN_ID RULE_ID --name NAME --match EXPRESSION --action ACTION --same-characteristics CHARACTERSTICS --requests REQUEST_PER_PERIOD --period PERIOD [--timeout TIMEOUT] [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULE_ID

RULE_ID は、高度なレート制限ルールの ID です。

--name

ルール名。

--match

ルールを実行するために一致する必要がある条件を指定します。 マッチ値については、 フィールド、関数、および式の使用を 参照してください。

--action

ルールで指定されたレートに達した際に実行されるアクション。 有効な値は block、 challenge、 js_challenge、 managed_challenge、 および です log。

--same-characteristics

CIS、ルールのリクエスト率を追跡する方法を定義するパラメータのセット。 1つ以上の特徴を使用してください: ip ip_nat, host, path, country, asnum.複雑な特性の場合は、代わりにJSONファイルまたはJSON文字列を使用する。

--requests

ルールがトリガーされる期間におけるリクエスト数。 有効な値の範囲は 1-1000000

--period

要求レートを評価する際に考慮する期間(秒単位)。 有効な値は、10、60、120、300、600、および3600です。

--timeout

レート制限ルールは、この期間、さらなる要求にルール・アクションを適用します。 有効な値は 0、 10、 60、 120、、 300、、 600、 および 3600 です 86400。

--enabled

ルールが有効か無効かを示します。 enabledの有効な値は および true です false。 (デフォルト値は false)

--json

高度なレート制限ルールを記述するために使用される JSON ファイルまたは JSON 文字列。

  • JSON データにおける必須フィールドは expression、 ratelimit 、、 です action。

  • expression: リクエストが高度なレート制限ルールに一致するための基準を定義します。

  • ratelimit: ratelimit パラメータを定義します。

  • characteristics CIS がルールのリクエストレートを追跡する方法を定義するパラメー タのセット。

  • requests_per_period: ルールがトリガーされる期間におけるリクエスト数。

  • period: リクエストレートを評価する際に考慮すべき時間(秒単位)。 有効な値は 10、 60、 120、 300、、 600、 および です 3600。

  • requests_to_origin: キャッシュされたアセットにレート制限を適用するかどうか。

  • mitigation_timeout: レート制限ルールは、その期間中に行われるその後のリクエストに対して、ルールアクションを適用します。 有効な値は、 0、 10、 60、 120、 300、 600、 3600、 86400。

  • counting_expression: リクエストレートを決定するために使用される基準を定義します。

  • action: ルールで指定されたレートに達した際に実行されるアクション。 有効な値は block、 challenge、 js_challenge、 managed_challenge、 log。

  • オプションのフィールドは description、 action_parameters、、 です enabled。

  • description: ルールの説明的な名称。

  • action_parameters: アクションのパラメータを定義します。

    • response: ブロック操作に対するカスタム応答を定義します。
    • status_code: レート制限によりリクエストをブロックする際、訪問者に返される HTTP ステータスコードを定義します。 ルール・アクションが「ブロック」の場合にのみ使用可能です。 有効な値の範囲は. から 400-499. までです。 デフォルト値は429です。
    • content_type: レート制限によりリクエストをブロックする際の、カスタム応答のコンテンツタイプを定義します。 ルール・アクションが「ブロック」の場合にのみ使用可能です。
    • content: レート制限によりリクエストがブロックされた場合に返される HTTP レスポンスの本文を定義します。 ルール・アクションが「ブロック」の場合にのみ使用可能です。
  • enabled: このルールを有効にするかどうか。

   Sample JSON data:
      {
         "description": "description",
         "expression": "(http.request.method eq \"POST\")",
         "ratelimit": {
            "characteristics": [
               "cf.unique_visitor_id",
               "cf.colo.id"
            ],
            "requests_to_origin": false,
            "counting_expression": "(ip.src.continent in {\"AN\"})",
            "requests_per_period": 10,
            "period": 10,
            "mitigation_timeout": 120
         },
         "action": "block",
         "action_parameters": {
            "response": {
               "status_code": 429,
               "content_type": "text/xml",
               "content": "reject"
            }
         },
         "enabled": false
      }
-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

高度なレート制限ルール c2e184081120413c86c3ab7e14069605 を、インスタンス cis-demo 下のドメイン 31984fea73a15b45779fa0df4ef62f9b 用に更新します。

ibmcloud cis advanced-rate-limiting rule-update DNS_DOMAIN_ID RULE_ID --name rule-name --match "(http.request.method eq \"POST\")" --action log --same-characteristics ip,ip_nat --requests 100 --period 10

ibmcloud cis advanced-rate-limiting rule-delete

IDを指定して拡張レート制限ルールを削除します。

ibmcloud cis advanced-rate-limiting rule-delete DNS_DOMAIN_ID RULE_ID [-f, --force] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULE_ID
RULE_ID は、高度なレート制限ルールの ID です。
-f, --force
確認のメッセージを表示せずに、高度なレート制限ルールを削除しようとしました。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo のドメイン 31984fea73a15b45779fa0df4ef62f9b のルール c2e184081120413c86c3ab7e14069605 を削除します。

ibmcloud cis advanced-rate-limiting rule-delete DNS_DOMAIN_ID RULE_ID

WAF 管理ルール

以下の managed-waf コマンドを使用して、WAFが管理するルールセットとルールを管理する。 マネージドWAFコマンドを使用する前に、まずAPIまたはGUIを使用して新しいWAFに移行します。 以前のバージョンのWAFコマンドは、移行後に機能しなくなることに留意してください。

ibmcloud cis managed-waf rulesets

すべての管理対象WAFルール・セットをリストします。

ibmcloud cis managed-waf rulesets DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo のドメイン 31984fea73a15b45779fa0df4ef62f9b の管理対象WAFルールセットをすべてリストアップします。

ibmcloud cis managed-waf rulesets DNS_DOMAIN_ID

ibmcloud cis managed-waf ruleset

管理対象WAFルール・セットの詳細を取得します。

ibmcloud cis managed-waf ruleset DNS_DOMAIN_ID RULESET_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULESET_ID
ルールセットのID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo のドメイン 31984fea73a15b45779fa0df4ef62f9b のルールセット c2e184081120413c86c3ab7e14069605 を表示します。

ibmcloud cis managed-waf ruleset DNS_DOMAIN_ID RULESET_ID

ibmcloud cis managed-waf deployment

デプロイ済みの管理対象WAFルールの詳細を取得します。

ibmcloud cis managed-waf deployment DNS_DOMAIN_ID RULE_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULE_ID
ルールのID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo の下にあるドメイン 31984fea73a15b45779fa0df4ef62f9b の展開ルール a2121e23-9e68-1218-a356-b78e23a8ec8a を表示します。

ibmcloud cis managed-waf deployment DNS_DOMAIN_ID RULE_ID

ibmcloud cis managed-waf deployments

デプロイ済みのすべての管理対象WAFルールをリストします。

ibmcloud cis managed-waf deployments DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

31984fea73a15b45779fa0df4ef62f9b ドメインの cis-demo インスタンス下のすべてのデプロイメントルールをリストアップします。

ibmcloud cis managed-waf deployments DNS_DOMAIN_ID

ibmcloud cis managed-waf deployment-add-exception

指定された管理対象WAFルールの実行をスキップする例外ルールを作成します。

ibmcloud cis managed-waf deployment-add-exception DNS_DOMAIN_ID --match EXPRESSION [--skip-rules RULES] [--enabled true|false] [--logging true|false] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis managed-waf deployment-add-exception DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

--match

ルールを実行するために一致する必要がある条件を指定します。 マッチ値については、 フィールド、関数、および式の使用を 参照してください。

--skip-rules

残りのすべてのルール、WAF管理対象ルール・セット、またはWAF管理対象ルール・セットのルールをスキップします。 例えば、--skip-rules RULESETID-1:RULEID-a,RULEID-b;RULESETID-2:RULEID-x,RULEID-y. です。 Setを選択 current すると、残りのルールをすべてスキップします。 デフォルト値はcurrentです。

--enabled

ルールが有効か無効かを示します。 デフォルト値は trueです。

--logging

スキップ・ルールに一致する要求をログに記録します。 デフォルト値は trueです。

--description

ルールの概要。

--json

マネージド WAF を記述するために使用される JSON ファイルまたは JSON 文字列。

  • JSON データにおける必須フィールドは expression、 action 、、 です action_parameters。

expression: ルール式。 action : 実行するルール・アクション。 有効な値は です skip。 action_parameters : ルール・アクション・パラメーター。 ruleset : 残りのすべてのルール、またはWAFで管理されている1つ以上のルールセットをスキップします。 rules : WAFで管理されるルールセットの1つ以上のルールをスキップします。

  • オプションのフィールドは description、 enabled、、 です logging。 description : ルールを簡単に説明します。 enabled : ルールが有効か無効かを示します。 logging : スキップ・ルールに一致する要求をログに記録します。 - enabled 無効にすると、マッチしたリクエストはファイアウォールイベントに表示されなくなります。

サンプル JSON データ:

   {
      "action": "skip",
      "expression": "(http.cookie eq \"example.com/contact?page=1234\")",
      "description": "rule name",
      "enabled": true,
      "logging": {
             "enabled": true
      },
      "action_parameters": {
         "rules": {
            "efb7b8c949ac4650a09736fc376e9aee": [
               "5de7edfa648c4d6891dc3e7f84534ffa",
               "e3a567afc347477d9702d9047e97d760"
            ],
            "c2e184081120413c86c3ab7e14069605": [
               "ef21b0a932ae422790f9249d213b85e6"
            ]
         }
      }
   }
-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo 下のドメイン 31984fea73a15b45779fa0df4ef62f9b に対する例外ルールを作成します。

ibmcloud cis managed-waf deployment-add-exception DNS_DOMAIN_ID --match "(http.cookie eq \"example.com/contact?page=1234\")" --skip-rules 'efb7b8c949ac4650a09736fc376e9aee:5de7edfa648c4d6891dc3e7f84534ffa' --enabled false --logging true

ibmcloud cis managed-waf deployment-update-exception

デプロイ済み管理対象WAFルール内の例外ルールを更新します。

ibmcloud cis managed-waf deployment-update-exception DNS_DOMAIN_ID RULE_ID [--match MATCH] [--skip-rules RULES] [--enabled true|false] [--logging true|false] [--description DESCRIPTION] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis managed-waf deployment-update-exception DNS_DOMAIN_ID RULE_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULE_ID

ルールのID。

--match

ルールを実行するために一致する必要がある条件を指定します。 マッチ値については、 フィールド、関数、および式の使用を 参照してください。

--skip-rules

残りのすべてのルール、WAF管理対象ルール・セット、またはWAF管理対象ルール・セットのルールをスキップします。 例えば、--skip-rules RULESETID-1:RULEID-a,RULEID-b;RULESETID-2:RULEID-x,RULEID-y. です。 Setを選択 current すると、残りのルールをすべてスキップします。 デフォルト値はcurrentです。

--enabled

ルールが有効か無効かを示します。 デフォルト値は trueです。

--logging

スキップ・ルールに一致する要求をログに記録します。 デフォルト値は trueです。

--description

ルールを簡潔に説明するためのものです。

--json

マネージド WAF を記述するために使用される JSON ファイルまたは JSON 文字列。

  • JSON データにおける必須フィールドは expression、 action、、および です action_parameters。

expression: ルール式。 action : 実行するルール・アクション。 有効な値は です skip。 action_parameters : ルール・アクション・パラメーター。 ruleset : 残りのすべてのルール、またはWAFで管理されている1つ以上のルールセットをスキップします。 rules : WAFで管理されるルールセットの1つ以上のルールをスキップします。

  • オプションのフィールドは description、 enabled、、 です logging。 description : ルールを簡単に説明します。 enabled : ルールが有効か無効かを示します。 logging : スキップ・ルールに一致する要求をログに記録します。 - enabled 無効にすると、マッチしたリクエストはファイアウォールイベントに表示されなくなります。

サンプル JSON データ:

      {
         "action": "skip",
         "expression": "(http.cookie eq \"example.com/contact?page=1234\")",
         "description": "rule name",
         "enabled": true,
         "logging": {
                "enabled": true
         },
         "action_parameters": {
            "rules": {
               "efb7b8c949ac4650a09736fc376e9aee": [
                  "5de7edfa648c4d6891dc3e7f84534ffa",
                  "e3a567afc347477d9702d9047e97d760"
               ],
               "c2e184081120413c86c3ab7e14069605": [
                  "ef21b0a932ae422790f9249d213b85e6"
               ]
            }
         }
      }
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo のドメイン 31984fea73a15b45779fa0df4ef62f9b に対する例外ルール e7ead74deb2b4c30a91c793f502f5e14 を更新します。

ibmcloud cis managed-waf deployment-update-exception DNS_DOMAIN_ID RULE_ID --match "(http.cookie eq \"example.com/contact?page=1234\")" --skip-rules 'efb7b8c949ac4650a09736fc376e9aee:5de7edfa648c4d6891dc3e7f84534ffa' --enabled false --logging true

ibmcloud cis managed-waf deployment-add-ruleset

管理対象ルール・セットをデプロイ済み管理対象WAFルールに追加します。

ibmcloud cis managed-waf deployment-add-ruleset DNS_DOMAIN_ID RULESET_ID [--match EXPRESSION] [--enabled true|false] [--override-action ACTION] [--override-status STATUS] [--paranoia-level LEVEL] [--override-rules RULE] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis managed-waf deployment-add-ruleset DNS_DOMAIN_ID RULESET_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULESET_ID

管理されたルールセットのID。

--match

ルールを実行するために一致する必要がある条件を指定します。 マッチ値については、 フィールド、関数、および式の使用を 参照してください。

--enabled

ルールが有効か無効かを示します。 デフォルト値は trueです。

--override-action

オーバーライドのルール・セット・アクション。 有効な値は managed_challenge、 block、 js_challenge、 log、 および です challenge。

--override-status

オーバーライドのルール・セットの状況。 有効な値は true および false です。

--paranoia-level

OWASPのパラノイアレベル。パラノイアレベルが高いほど、より厳格なルールが適用されます。 有効な値は PL1, PL2, PL3, PL4 で、 CIS OWASP Core Ruleset でのみ利用可能です。

--override-rules

オーバーライドのルール・オプション。 例: --override-rules rule=RULE_ID,action=ACTION,enabled=STATUS。 OWASP Core Rulesetの場合、スコアしきい値をオーバーライドすることもできます。 例えば、--override-rules rule=6179ae15870a4bb7b2d480d4843b323c,score-threshold=25 です。

--json

マネージド WAF ルールを記述するために使用される JSON ファイルまたは JSON 文字列。

  • JSON データにおける必須フィールドは expression、 action、、および です action_parameters。

expression: ルール式。 action : 実行するルール・アクション。 有効な値は です skip。 action_parameters : ルール・アクション・パラメーター。 id : オーバーライドのルール・セットID。 overrides : オーバーライドのルール・オプション。 action : オーバーライドのルール・セット・アクション。 有効な値は、 managed_challenge、 block、 js_challenge、"log"、"challenge"。 enabled : オーバーライドのルール・セットの状況。 有効な値は true と false です。 rules: オーバーライドのルール・オプション。 id: オーバーライドのルールID。 action: オーバーライドのルール・アクション。 有効な値は managed_challenge、 block、 js_challenge、 log、 challenge。 enabled: オーバーライドのルールの状況。 score_threshold: OWASP の異常スコアしきい値。 ファイアウォールを起動させるスコア閾値を設定します。 categories: OWASPパラノイア・レベルを定義し、以下の場合にのみ有効とする CIS OWASP core ruleset category:OWASPのパラノイアレベル。パラノイアレベルが高いほど、より攻撃的なルールが有効になる。 enabled: このOWASPパラノイアレベルが有効になっているかどうか。

  • オプションのフィールドは description および です enabled。 description : ルールを簡単に説明します。 enabled : ルールが有効か無効かを示します。

サンプル JSON データ:

      {
         "action": "execute",
         "description": "CIS Managed Ruleset",
         "enabled": true,
         "expression": "(http.cookie eq \"example.com/contact?page=1234\")",
         "action_parameters": {
            "id": "efb7b8c949ac4650a09736fc376e9aee",
            "overrides": {
               "action": "block",
               "enabled": false,
               "rules": [
                  {
                     "id": "5de7edfa648c4d6891dc3e7f84534ffa",
                     "action": "managed_challenge"
                  },
                  {
                     "id": "e3a567afc347477d9702d9047e97d760",
                     "action": "log",
                     "enabled": true
                  }
               ]
            }
      }
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo の下にあるドメイン 31984fea73a15b45779fa0df4ef62f9b 用の管理されたルールセットを展開します。

ibmcloud cis managed-waf deployment-add-ruleset DNS_DOMAIN_ID RULESET_ID --match true --enabled true --override-action block --override-status true --override-rules rule=5de7edfa648c4d6891dc3e7f84534ffa,action=managed_challenge --override-rules rule=e3a567afc347477d9702d9047e97d760,action=action,enabled=true

ibmcloud cis managed-waf deployment-update-ruleset

デプロイ済み管理対象WAFルール内の管理対象ルール・セットを更新します。

ibmcloud cis managed-waf deployment-update-ruleset DNS_DOMAIN_ID RULE_ID [--match EXPRESSION] [--enabled true|false] [--override-action ACTION] [--override-status STATUS] [--paranoia-level LEVEL] [--override-rules RULE] [--reset-all] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis managed-waf deployment-update-ruleset DNS_DOMAIN_ID RULE_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULE_ID

デプロイされた管理ルールのID。

--match

ルールを実行するために一致する必要がある条件を指定します。 マッチ値については、 フィールド、関数、および式の使用を 参照してください。

--enabled

ルールが有効か無効かを示します。 デフォルト値は trueです。

--override-action

オーバーライドのルール・セット・アクション。 有効な値は managed_challenge、 block、 js_challenge、 log、 および です challenge。

--override-status

オーバーライドのルール・セットの状況。 有効な値は true および false です。

--paranoia-level

OWASPのパラノイアレベル。パラノイアレベルが高いほど、より厳格なルールが適用されます。 有効な値は PL1, PL2, PL3, PL4 で、 CIS OWASP Core Ruleset でのみ利用可能です。

--override-rules

オーバーライドのルール・オプション。 例えば、--override-rules rule=RULE_ID,action=ACTION,enabled=STATUS です。 OWASP Core Rulesetの場合、スコアしきい値をオーバーライドすることもできます。 例えば、--override-rules rule=6179ae15870a4bb7b2d480d4843b323c,score-threshold=25 です。

--reset-all

すべてのオーバーライド・ルールをデフォルト設定にリセットします。

--json

マネージド WAF ルールを記述するために使用される JSON ファイルまたは JSON 文字列。

  • JSON データにおける必須フィールドは expression、 action、、および です action_parameters。

expression: ルール式。 action : 実行するルール・アクション。 有効な値は です skip。 action_parameters : ルール・アクション・パラメーター。 id : オーバーライドのルール・セットID。 overrides : オーバーライドのルール・オプション。 action : オーバーライドのルール・セット・アクション。 有効な値は managed_challenge, block, および js_challenge, log, challenge。 enabled: オーバーライドのルールセットの状態。 有効な値は true と false です。 rules : オーバーライドのルール・オプション。 id : オーバーライドのルールID。 action : オーバーライドのルール・アクション。 有効な値は managed_challenge、 block、 js_challenge、 log、 challenge。 enabled : オーバーライドのルールの状況。 score_threshold : OWASP の異常スコアしきい値。 ファイアウォールを起動させるスコア閾値を設定します。 categories : OWASPパラノイア・レベルを定義し、以下の場合にのみ有効とする CIS OWASP core ruleset category OWASPのパラノイア・レベルでは、パラノイア・レベルが高いほど、よりアグレッシブなルールが有効になります。 enabled : このOWASPパラノイアレベルが有効かどうか。

  • オプションのフィールドは description および です enabled。 description: ルールを簡単に説明します。 enabled: ルールが有効か無効かを示します。

サンプル JSON データ:

      {
         "action": "execute",
         "description": "CIS Managed Ruleset",
         "enabled": true,
         "expression": "(http.cookie eq \"example.com/contact?page=1234\")",
         "action_parameters": {
            "id": "efb7b8c949ac4650a09736fc376e9aee",
            "overrides": {
               "action": "block",
               "enabled": false,
               "rules": [
                  {
                     "id": "5de7edfa648c4d6891dc3e7f84534ffa",
                     "action": "managed_challenge"
                  },
                  {
                     "id": "e3a567afc347477d9702d9047e97d760",
                     "action": "log",
                     "enabled": true
                  }
               ]
            }
      }
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo のドメイン 31984fea73a15b45779fa0df4ef62f9b の管理ルールセットルール 1a18a1ea7fc043c68761bc69adcbb11c を更新します。

ibmcloud cis managed-waf deployment-update-ruleset DNS_DOMAIN_ID RULE_ID --match true --enabled true --override-action block --override-status true --override-rules rule=5de7edfa648c4d6891dc3e7f84534ffa,action=managed_challenge --override-rules rule=e3a567afc347477d9702d9047e97d760,action=action,enabled=true

WAF カスタム・ルール

以下の custom-waf コマンドを使用して、WAFカスタムルールを管理する。 ファイアウォールルールがWAFカスタムルールで管理されるようになりました。

ibmcloud cis custom-waf rules

すべてのカスタム・ルールをリストアップします。

ibmcloud cis custom-waf rules DNS_DOMAIN_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo の下にあるドメイン 31984fea73a15b45779fa0df4ef62f9b のすべてのカスタムルールをリストする。

ibmcloud cis custom-waf rules DNS_DOMAIN_ID

ibmcloud cis custom-waf rule

カスタムルールの詳細を確認する。

ibmcloud cis custom-waf rule DNS_DOMAIN_ID RULE_ID [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULE_ID
ルールのID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo の下にドメイン 9343630b9bd5c6e6899834d77f9e50ff のカスタムルール b94632a4cd5a49ed830544d91417a98c を表示する。

ibmcloud cis custom-waf rule DNS_DOMAIN_ID RULE_ID

ibmcloud cis custom-waf rule-create

カスタム・ルールを作成します。

ibmcloud cis custom-waf rule-create DNS_DOMAIN_ID --match EXPRESSION --action ACTION [--description DESCRIPTION] [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis custom-waf rule-create DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

--match

ルールを実行するために一致する必要がある条件を指定します。 マッチ値については、 フィールド、関数、および式の使用を 参照してください。

--action

実行するルール・アクション。 有効な値は、block、challenge、js_challenge、managed_challenge、log、およびskipです。 「block」と「skip」のアクションには、代わりに json ファイルまたは json 文字列を使用してください。

--enabled

ルールが有効か無効かを示します。 デフォルト値は falseです。

--description

ルールの概要。

--json

カスタムルールを記述するために使用されるJSONファイルまたはJSON文字列。

  • JSON データにおける必須フィールドは expression および です action。

  • expression: ルールが実行されるために満たす必要がある条件を指定します。

  • action: 実行するルールアクション。 有効な値は block、 challenge、 js_challenge、 managed_challenge、、 log、 および です skip。

  • オプションのフィールドは、 description、 enabled、 logging、 action_parameters。

  • action_parameters: ルールアクションのパラメータ。

  • ruleset: 残りのすべてのルール、または1つ以上のWAF管理ルールセットをスキップします。 有効な値は です current。

  • phases: リクエストの照合において、WAFコンポーネントをスキップします。 有効な値は http_ratelimit、 http_request_firewall_managed、 http_request_sbfm である。

  • products マッチング要求に対して特定のセキュリティ製品をスキップする。 有効な値は waf、 rateLimit、 securityLevel、 hot、 bic、 uaBlock、 zoneLockdown。

  • response: アクション block に対するカスタムレスポンスを定義します。

    • status_code: 応答の HTTP ステータスコードを、以下の範囲から選択してください 400-499。
    • content_type カスタムレスポンスのコンテンツタイプ。 有効なレスポンス・タイプは、text/html、 text/plain、 application/json、 text/xml。
    • content: レスポンス本文。
  • description ルールを簡単に説明する。

  • enabled: ルールが有効か無効かを示します。 このフィールドを無効にすると、マッチしたリクエストはファイアウォールリクエストに表示されません。

  • logging: スキップルールに一致するログリクエスト。 このフィールドは「skip」アクションの場合のみ利用可能です。

サンプル JSON データ:

      {
        "description": "test-custom-rule",
        "expression": "(http.cookie contains \"test\")",
        "action": "skip",
        "logging": {
                "enabled": true
            },
        "action_parameters": {
          "ruleset": "current",
            "phases": [
                    "http_ratelimit",
                    "http_request_firewall_managed",
                    "http_request_sbfm"
                ],
                "products": [
                    "waf",
                    "rateLimit",
                    "securityLevel",
                    "hot",
                    "bic",
                    "uaBlock",
                    "zoneLockdown"
                ]
        },
        "enabled": true
      }
-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo の下にドメイン 9343630b9bd5c6e6899834d77f9e50ff のカスタムルールを作成する。

ibmcloud cis custom-waf rule-create DNS_DOMAIN_ID --action challenge --description "rule 1" --enabled true --match "(http.host eq \"www.example.com\")"

ibmcloud cis custom-waf rule-update

カスタム・ルールを更新します。

ibmcloud cis custom-waf rule-update DNS_DOMAIN_ID [--match EXPRESSION] [--action ACTION] [--description DESCRIPTION] [--enabled true|false] [-i, --instance INSTANCE] [--output FORMAT]
ibmcloud cis custom-waf rule-update DNS_DOMAIN_ID (--json @JSON_FILE | JSON_STRING) [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULE_ID

ルールのID。

--match

ルールを実行するために一致する必要がある条件を指定します。 マッチ値については、 フィールド、関数、および式の使用を 参照してください。

--action

実行するルール・アクション。 有効な値は、block、challenge、js_challenge、managed_challenge、log、およびskipです。 「block」と「skip」のアクションには、代わりに json ファイルまたは json 文字列を使用してください。

--enabled

ルールが有効か無効かを示します。 デフォルト値は falseです。

--description

ルールの概要。

--json

カスタムルールを記述するために使用されるJSONファイルまたはJSON文字列。

  • JSON データにおける必須フィールドは expression および です action。

  • expression: ルールが実行されるために満たす必要がある条件を指定します。

  • action: 実行するルールアクション。 有効な値は block、 challenge、 js_challenge、 managed_challenge、、 log、 および です skip。

  • オプションのフィールドは、 description、 enabled、 logging、 action_parameters。

  • action_parameters: ルールアクションのパラメータ。

  • ruleset: 残りのすべてのルール、または1つ以上のWAF管理ルールセットをスキップします。 有効な値は current

  • phases: リクエストの照合において、WAFコンポーネントをスキップします。 有効な値は http_ratelimit、 http_request_firewall_managed、 http_request_sbfm である。

  • products マッチング要求に対して特定のセキュリティ製品をスキップする。 有効な値は waf、 rateLimit、 securityLevel、 hot、 bic、 uaBlock、 zoneLockdown。

  • response: blockアクションに対するカスタム応答を定義します。

    • status_code: 応答の HTTP ステータスコードを、以下の範囲から選択してください 400-499。
    • content_type カスタムレスポンスのコンテンツタイプ。 有効なレスポンス・タイプは text/html、 text/plain、 application/json、 text/xml である。
    • content: レスポンス本文。
  • description ルールを簡単に説明する。

  • enabled: ルールが有効か無効かを示します。 このフィールドを無効にすると、マッチしたリクエストはファイアウォールリクエストに表示されません。

  • logging: スキップルールに一致するログリクエスト。 このフィールドは「skip」アクションの場合のみ利用可能です。

サンプル JSON データ:

      {
        "description": "test-custom-rule",
        "expression": "(http.cookie contains \"test\")",
        "action": "block",
        "action_parameters": {
          "response": {
          "status_code": 429,
          "content_type": "text/xml",
          "content": "reject"
          }
        },
        "enabled": true
      }
-i, --instance

インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。

--output

出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo の下にあるドメイン 9343630b9bd5c6e6899834d77f9e50ff のカスタムルール b94632a4cd5a49ed830544d91417a98c を更新する。

ibmcloud cis custom-waf rule-update DNS_DOMAIN_ID RULE_ID --enabled false --description "rule 1" --match "(http.host eq \"www.example.com\")"

ibmcloud cis custom-waf rule-order-update

カスタム・ルールの実行順序を変更します。

ibmcloud cis custom-waf rule-order-update DNS_DOMAIN_ID RULE_ID [--before RULE_ID] [--after RULE_ID] [--index INDEX] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULE_ID
カスタムルールのID。
--before
ruleの前にplacesを配置する <RULE_ID>。
--after
ルールの後にルールを配置する <RULE_ID>。
--index
整数で指定された正確な位置にルールを配置します。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo の下にあるドメイン 9343630b9bd5c6e6899834d77f9e50ff のルール 2ed2dd160cb745feb415414544d97c70 の前にカスタムルール 4eae81b170f644f795da017001383de7 を置く。

ibmcloud cis custom-waf rule-order-update DNS_DOMAIN_ID RULE_ID --before RULE_ID

ibmcloud cis custom-waf rule-delete

ID で指定したカスタム・ルールを削除します。

ibmcloud cis custom-waf rule-delete DNS_DOMAIN_ID RULE_ID [-f, --force] [-i, --instance INSTANCE] [--output FORMAT]

コマンド・オプション

DNS_DOMAIN_ID

DNSドメインのID。

RULE_ID
カスタムルールのID。
-i, --instance
インスタンスの名前または ID。 インスタンス名やIDが設定されていない場合は、 ibmcloud cis instance-set INSTANCE で指定されたコンテキスト・インスタンスが使用される。
-f, --force
確認のメッセージを表示せずにカスタムルールを削除しようとしました。
--output
出力形式。 現在、 が唯一サポートされている値です json。

例

インスタンス cis-demo の下にあるドメイン 9343630b9bd5c6e6899834d77f9e50ff のカスタムルール e9fad806880c4c42bd7ebeec8dcba4e6 を削除する。

ibmcloud cis custom-waf rule-delete DNS_DOMAIN_ID RULE_ID

プライベート・エンドポイントのサポート

CIS CLI の使用時にデータに対する制御とセキュリティーを向上させるには、CIS エンドポイントへのプライベート経路を使用するという方法があります。 インターネットからは、プライベート・ルートにアクセスすることも到達することもできません。 CIS プライベート・エンドポイントを使用することで、パブリック・ネットワークからの脅威からデータを保護し、プライベート・ネットワークを論理的に拡張できます。

限られた数の CLI コマンドがリージョン・ベースでサポートされています。 以下のリージョンでは、プライベート・エンドポイントがサポートされます。

  • us-south
  • us-east

プライベート・エンドポイントを使用した CLI へのログイン

CLI からプライベートエンドポイントにログインするには、次のコマンドを使用します:

ibmcloud login -a private.cloud.ibm.com

サポート対象リージョンのターゲット設定

プライベート・エンドポイントを設定する際にはターゲットのリージョンを指定する必要があります。 サポートされているリージョンをターゲットにするには、次のコマンドを使用します。

ibmcloud target -r [region]

CIS CLI でのプライベート・エンドポイントの使用

すべてのコマンドがプライベート・エンドポイントをサポートしています。次に例を示します。

ibmcloud cis domains --instance cis-demo