Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créez une application d'accès pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Répertoriez toutes les applications d'accès pour les domaines 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-apps DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Affichez les détails d'une application d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

--name

Nom de l'application. Obligatoire.

--domain

Le domaine et le chemin d'accès bloqués par Access. Obligatoire.

--session-duration

Définit la durée de validité des jetons émis pour cette application. Les valeurs valides sont 30m, 6h, 12h, 24h, 168het 730h.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mettez à jour l'application d'accès a5836c2a7ea72d2e225890caea70ae32.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimez une application d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-app-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--name

Nom du certificat. Obligatoire.

--ca-cert-file

Fichier CA racine de vos certificats. Obligatoire.

--associated-hostnames

Les noms d'hôte requis pour ce certificat.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Créez un certificat d'accès pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Répertoriez tous les certificats d'accès pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificates DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_CERTIFICATE_ID

L'identifiant du certificat d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Affichez les détails du certificat d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-certificate DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_CERTIFICATE_ID

L'identifiant du certificat d'accès. Obligatoire.

--name

Nom du certificat. Obligatoire.

--associated-hostnames

Les noms d'hôte requis pour ce certificat. Obligatoire.

Les noms d'hôte associés sont réinitialisés s'ils ne sont pas spécifiés par associated-hostnames.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mettre à jour le certificat d'accès a5836c2a7ea72d2e225890caea70ae32.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_CERTIFICATE_ID

L'identifiant du certificat d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimez le certificat d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-certificate-delete DNS_DOMAIN_ID ACCESS_CERTIFICATE_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenez les paramètres des certificats d'accès pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis access-certificates-settings DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-f, --feature

Fonction des paramètres des certificats. Valeurs valides :

client_certificate_forwarding

Le contenu du certificat client et sa signature SHA256 sont transmis aux serveurs d'origine via les en-têtes CF-Client-Cert-SHA256 CF-Client-Cert-DER_BASE64 et.

-v, --value

Valeur appliquée à la fonction pour les certificats.

client_certificate_forwarding

Indiquez si le certificat client doit être transféré ou non pour le nom d'hôte. Par exemple, -v host1=on,host2=on,host3=off.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mettez à jour les paramètres des certificats d'accès pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

--name

Nom de la stratégie. Obligatoire.

--decision

Définit l'action entreprise par Access si la politique correspond à l'utilisateur. La valeur valide est non_identity. Obligatoire.

--include

Règle incluse de la stratégie. Les valeurs valides sont certificate et common_name. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créer une politique d'accès pour l'application d'accès a5836c2a7ea72d2e225890caea70ae32.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Répertoriez toutes les stratégies d'accès pour l'application d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-policies DNS_DOMAIN_ID ACCESS_APPLICATION_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

ACCESS_POLICY_ID

L'identifiant de la politique d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Affichez les détails de la stratégie d'accès a5836c2a7ea72d2e225890caea70ae32.

ibmcloud cis access-policy DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

ACCESS_APPLICATION_ID

L'identifiant de l'application d'accès. Obligatoire.

ACCESS_POLICY_ID

L'identifiant de la politique d'accès. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimez la stratégie d'accès 65fe21071877669cc69544642bc6c4c4.

ibmcloud cis access-policy-delete DNS_DOMAIN_ID ACCESS_APPLICATION_ID ACCESS_POLICY_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--all

Purge de tous les fichiers en cache. Cette option est mutuellement exclusive avec --file.

--file

Supprimez un ou plusieurs fichiers de façon granulaire en indiquant des URL. Cette option est mutuellement exclusive avec --all.

--tag

Supprimez un ou plusieurs fichiers de façon granulaire via le Cache-Tag associé. Cette option est mutuellement exclusive avec --all. Plans Enterprise uniquement

--host

Supprimez un ou plusieurs fichiers de façon granulaire en indiquant l'hôte. Cette option est mutuellement exclusive avec --all. Plans Enterprise uniquement

--prefix

Supprimez un ou plusieurs fichiers de façon granulaire via un préfixe. Cette option est mutuellement exclusive avec --all. Plans Enterprise uniquement

-f, --force

Purge de tous les fichiers en cache sans demande de confirmation.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Effacez tous les fichiers d'actifs mis en cache du domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenez les paramètres de mise en cache du domaine 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis cache-settings DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--caching-level

Précisez dans quelles conditions d' URL s vous souhaitez fournir les ressources mises en cache à l'utilisateur. Les valeurs valables sont no-query-string, query-string-independent, et query-string-dependent.

• no-query-string: Fournit des ressources à partir du cache uniquement lorsqu'aucune chaîne de requête n'est présente.
• query-string-independent: Fournit la même ressource à tous les utilisateurs, quelle que soit la chaîne de requête.
• query-string-dependent: Fournit une ressource différente à chaque fois que la chaîne de requête change.

--browser-expiration

Précisez la durée pendant laquelle vous souhaitez que le navigateur conserve les ressources en cache.

• Les valeurs valides sont respect-existing-header, 30s, 1M, 5M, 20M,, 30M, 1h, 2h, 4h, 8h``16h,, 1d``3d, 8d, 16d, 1m``6m, et 1y.
• 30s, 1M, 5M, et ne 20M sont disponibles que pour les instances des formules Enterprise ou Security.
• 30s signifie 30 seconds.
• 30M signifie 30 minutes.
• 1h signifie 1 hour.
• 1d signifie 1 day.
• 1m signifie 1 month.
• 1y signifie 1 year.

--development-mod

Ignorer tous les caches de périphérie et envoyer le trafic vers vos serveurs d'origine.

--serve-stale-content

Continuer à fournir du contenu mis en cache aux utilisateurs lorsque les serveurs d'origine sont hors ligne, même si ce contenu a expiré.

--query-string-sort: Dans le cache, CIS considère que les fichiers comportant les mêmes chaînes de requête sont identiques, quel que soit l'ordre de ces chaînes.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mettez à jour les paramètres de mise en cache du domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemple

ibmcloud cis custom-lists lists

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemple

ibmcloud cis custom-lists list LIST_ID --output json

Options de commande

--kind

Type de liste personnalisée. Les valeurs valables sont ip, asn, et hostname.

--name

Le nom de la liste.

--description

Description de la liste.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire une liste personnalisée.

Les champs obligatoires dans les données JSON sont les suivants :

kind: Type de liste personnalisée. Les valeurs valables sont ip, asn, et hostname.

name nom de la liste : Le nom de la liste.

Le champ facultatif est le suivant :

"description": Description de la liste.

Exemple de données JSON :

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

Exemples

ibmcloud cis custom-lists list-create --kind ip --name iplistone --instance INSTANCE

ibmcloud cis custom-lists list-create --json @example.json --instance INSTANCE

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

--description

Décrivez brièvement la liste.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire une liste personnalisée.

Le champ facultatif est le suivant :

"description": Pour décrire brièvement la liste.

Exemple de données JSON :

  {
    "description": "string"
  }

Exemples

ibmcloud cis custom-lists list-update LIST_ID --description "description example"

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

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

-f, --force

Tentative de suppression d'une liste personnalisée sans demande de confirmation.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

Exemple

ibmcloud cis custom-lists list-delete LIST_ID

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemple

ibmcloud cis custom-lists items LIST_ID

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

ITEM_ID

L'ID de l'élément de liste personnalisé.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemple

ibmcloud cis custom-lists item LIST_ID ITEM_ID

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

--asn

La valeur de l'ASN.

--ip

L'adresse de l' IPv4.

--hostname

Nom de l'hôte.

--comment

Fournir un bref commentaire sur le point.

-i, --instance

Nom ou ID de l'instance. Si l'instance ou l'ID n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire une liste personnalisée.

Les champs obligatoires dans les données JSON sont les suivants :

items liste d'éléments de liste personnalisés à créer.

asn: L'ASN.

hostname: Le nom d'hôte.

ip l'adresse IPv4: L'adresse.

comment le Président : Il s'agit de formuler un bref commentaire sur le point de l'ordre du jour.

Exemple de données JSON :

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

Exemples de commande

ibmcloud cis custom-lists item-create LIST_ID --ip 192.0.0.3

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

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire une liste personnalisée.

Les champs obligatoires dans les données JSON sont les suivants :

items liste d'éléments de liste personnalisés à créer.

asn: La valeur de l'ASN.

hostname: Le nom d'hôte.

ip l'adresse IPv4: L'adresse.

comment le Président : Il s'agit de formuler un bref commentaire sur le point de l'ordre du jour.

Exemple de données JSON :

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

-f, --force

Tentative de suppression d'une liste personnalisée sans demande de confirmation.

--output value

Format de sortie. Actuellement, json est la seule valeur prise en charge.

-i, --instance

Nom ou ID de l'instance. Si la valeur ou l'ID de l'instance n'est pas définie, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

Exemple

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

Options de commande

LIST_ID

L'identifiant de la liste personnalisée.

--item-id

CUSTOM_LIST_ITEM_ID est l'ID de l'élément de la liste personnalisée.

-f, --force

Tentative de suppression d'une liste personnalisée sans demande de confirmation.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire une liste personnalisée.

Les champs obligatoires dans les données JSON sont les suivants :

items liste des éléments de la liste personnalisée à supprimer par ID.

id iD : ID unique de l'élément de la liste personnalisée.

Exemple de données JSON :

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

Exemples

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

Options de commande

OPERATION_ID

L'ID de l'opération de liste personnalisée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemple

ibmcloud cis custom-lists operation OPERATION_ID --output json

Options de commande

PAGE_ID

Nom du type de page personnalisée. Les valeurs valides sont basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack, waf_block, waf_challenge, 1000_errors, 500_errors. Obligatoire.

PAGE_URL

URL associée à la page personnalisée. Par exemple, http://www.example.com/example.html. La valeur default indique qu'il faut utiliser la page par défaut. Obligatoire.

-d, --domain

ID domaine DNS.

-i,- --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mettez à jour la page basic_challenge pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

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

Options de commande

PAGE_ID

Nom du type de page personnalisée. Les valeurs valides sont basic_challenge, country_challenge, ip_block, ratelimit_block, serve_stale_content, under_attack,, waf_block, waf_challenge``1000_errors, et 500_errors. Obligatoire.

-d, --domain

ID domaine DNS.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenez la page basic_challenge pour le domaine 31984fea73a15b45779fa0df4ef62f9b.

ibmcloud cis custom-page basic_challenge -d DNS_DOMAIN_ID

Options de commande

-d, --domain

ID domaine DNS.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Liste des pages personnalisées existantes pour le domaine DNS_DOMAIN_ID.

ibmcloud cis custom-pages -d DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--name

Nom de l'enregistrement DNS.

--type

Type de l'enregistrement DNS.

--content

Contenu de l'enregistrement DNS.

--ttl

Durée de vie de l'enregistrement DNS. Une valeur de 1 correspond à automatic. La valeur par défaut est 1.

--proxied

Contrôlez si le trafic passe par les fonctions de sécurité et de performances sur CIS. CIS Proxie le trafic uniquement pour les enregistrements CNAME A, AAAA, et. Les valeurs admises sont true et false.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire un enregistrement DNS. Les types d'enregistrement DNS pris en charge sont : A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA et PTR.

• Pour les types A, AAAA, CNAME, NS, : TXT
  • Les zones obligatoires dans les données JSON sont name, type, content.
  • Les champs facultatifs sont ttl: proxied
    • proxied Contrôlez si le trafic passe par les fonctions de sécurité et de performances sur CIS. CIS Les proxys ne gèrent que le trafic pour A,``AAAA les enregistrements CNAME et.

Exemple de données 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"
}

• Pour le type : PTR
  • Les zones obligatoires dans les données JSON sont name, type, content.
  • La zone facultative est ttl.

Exemple de données JSON :

{
 "name": "1.2.3.4",
 "type":"PTR",
 "content": "abc.test.com"
}

• Pour le type : MX
  • Les zones obligatoires dans les données JSON sont name, type, content.
  • Les champs facultatifs sont ttl et priority.

Exemple de données JSON :

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

• Pour le type : LOC
  • Les zones obligatoires dans les données JSON sont name, type, data :
    • data:
      • lat_degrees: degrés de latitude.
      • lat_minutes: Quelques minutes de latitude
      • lat_seconds: Secondes de latitude.
      • lat_direction: Direction de latitude.
      • long_degrees: degrés de longitude.
      • long_minutes: Minutes de longitude.
      • long_seconds: Secondes de longitude.
      • long_direction: Direction de la longitude.
      • altitude: Altitude du lieu en mètres.
      • size: Dimensions du site en mètres.
      • precision_horz: Précision horizontale de la localisation.
      • precision_vert: Précision verticale de la localisation.
    • La zone facultative est ttl.

Exemple de données 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
   }
}

• Pour le type : SRV
  • Les zones obligatoires dans les données JSON sont type, data :
    • data: - : service Type de service, précédé d'un trait de soulignement. - : proto Un protocole valide. - : priority Priorité. - : weight Le poids de l'enregistrement. - : port Le port du service. - : target Un nom d'hôte valide.
    • La zone facultative est ttl.

Exemple de données JSON :

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

• Pour le type CAA :
  • Les champs obligatoires dans les données JSON sont name, type, et data.
  • La zone facultative est ttl.

Exemple de données JSON :

{
   "name": "testCAA.yourdomain.com",
   "type": "CAA",
   "data": {
         "tag": "issue",
         "value": "letsencrypt.org"
   }
}

-s, --json-str

Obsolète. Données JSON utilisées pour décrire un enregistrement DNS.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créer un enregistrement DNS dans le domaine 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"

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

DNS_RECORD_ID

L'identifiant de l'enregistrement DNS. Obligatoire.

--name

Nom de l'enregistrement DNS.

--type

Type de l'enregistrement DNS.

--content

Contenu de l'enregistrement DNS.

--ttl

Durée de vie de l'enregistrement DNS. Une valeur de 1 correspond à automatic. La valeur par défaut est 1.

--proxied

Contrôlez si le trafic passe par les fonctions de sécurité et de performances sur CIS. CIS Proxie le trafic uniquement pour les enregistrements CNAME A, AAAA, et. Les valeurs admises sont true et false.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire un enregistrement DNS. Les types d'enregistrement DNS pris en charge sont : A, AAAA, CNAME, NS, TXT, MX, LOC, SRV, CAA et PTR.

• Pour les types A, AAAA, CNAME, NS, : TXT
  • Les zones obligatoires dans les données JSON sont name, type, content.
  • Les champs facultatifs sont et ttl: proxied
    • proxied Contrôlez si le trafic passe par les fonctions de sécurité et de performances sur CIS. CIS Les proxys ne gèrent que le trafic des enregistrements CNAME A, AAAA, et.

Exemple de données 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"
}

• Pour le type : PTR
  • Les zones obligatoires dans les données JSON sont name, type, content.
  • La zone facultative est ttl.

Exemple de données JSON :

{
 "name": "1.2.3.4",
 "type":"PTR",
 "content": "abc.test.com"
}

• Pour le type : MX

  • Les zones obligatoires dans les données JSON sont name, type, content.
  • Les champs facultatifs sont ttl et priority.

  Exemple de données JSON :

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

• Pour le type : LOC

  • Les zones obligatoires dans les données JSON sont name, type, data :
    • data:
      • lat_degrees: degrés de latitude.
      • lat_minutes: Quelques minutes de latitude
      • lat_seconds: Secondes de latitude.
      • lat_direction: Direction de latitude.
      • long_degrees: degrés de longitude.
      • long_minutes: Minutes de longitude.
      • long_seconds: Secondes de longitude.
      • long_direction: Direction de la longitude.
      • altitude: Altitude du lieu en mètres.
      • size: Dimensions du site en mètres.
      • precision_horz: Précision horizontale de la localisation.
      • precision_vert: Précision verticale de la localisation.
  • La zone facultative est ttl.

  Exemple de données 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
   }
}

• Pour le type : SRV

  • Les zones obligatoires dans les données JSON sont type, data :
    • data:
      • service: un type de service, précédé d'un trait de soulignement.
      • proto: Un protocole valide.
      • priority: Priorité.
      • weight: Le poids de l'enregistrement.
      • port: Le port du service.
      • target: Un nom d'hôte valide.
  • La zone facultative est ttl.

  Exemple de données JSON :

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

• Pour le type : CAA

  • Les champs obligatoires dans les données JSON sont name, type, data
  • La zone facultative est ttl.

  Exemple de données JSON :

{
   "name": "testCAA.yourdomain.com",
   "type": "CAA",
   "data": {
         "tag": "issue",
         "value": "letsencrypt.org"
   }
}

-s, --json-str

Obsolète. Données JSON utilisées pour décrire un enregistrement DNS.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mettre à jour un enregistrement DNS dans le domaine 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"

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

DNS_RECORD_ID

L'identifiant de l'enregistrement DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenir les détails de l'enregistrement DNS dans le domaine DNS_DOMAIN_ID.

ibmcloud cis dns-record DNS_DOMAIN_ID DNS_RECORD_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

DNS_RECORD_ID

L'identifiant de l'enregistrement DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer un enregistrement DNS dans le domaine DNS_DOMAIN_ID.

ibmcloud cis dns-record-delete DNS_DOMAIN_ID DNS_RECORD_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--type

Type d'enregistrements DNS à afficher.

--name

Valeur de zone de nom pour le filtrage.

--content

Valeur de zone de contenu pour le filtrage.

--page

Nombre de pages de résultats paginés.

--per_page

Nombre maximal d'enregistrements DNS par page.

--order

Champ permettant de trier la liste des enregistrements DNS. Les valeurs valides sont type, name, content, ttl, et proxied.

--direction

Ordre de tri des résultats (par ordre croissant ou décroissant). Les valeurs valides sont asc et desc.

--match

Il faut vérifier si la correspondance doit porter sur tous les paramètres de recherche ou sur au moins l'un d'entre eux. Les valeurs valides sont any et all.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Répertorier tous les enregistrements DNS du domaine DNS_DOMAIN_ID.

ibmcloud cis dns-records DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--file

Configuration BIND à importer. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Importer la configuration BIND dans le domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--file

Le fichier de configuration BIND qui enregistre les enregistrements DNS exportés.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Exporter la configuration BIND pour le domaine DNS_DOMAIN_ID.

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

Options de commande

type

Indiquez la configuration de type de domaine. Les valeurs valables sont full et partial ( full par défaut).

• full: Une zone complète implique que le DNS est hébergé.
• partial: Une zone partielle implique un domaine configuré avec un enregistrement CNAME.

jump-start

Tenter automatiquement d'extraire les enregistrements DNS existants.

DNS_DOMAIN_NAME

Le nom de domaine complet (FQDN) du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Ajouter un domaine DNS_DOMAIN_NAME.

ibmcloud cis domain-add DNS_DOMAIN_NAME

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Reprenez le domaine spécifié.

ibmcloud cis domain-resume DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Suspendez le domaine spécifié.

ibmcloud cis domain-pause DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Affichez les détails du domaine spécifié.

ibmcloud cis domain DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimez le domaine spécifié.

ibmcloud cis domain-remove DNS_DOMAIN_ID

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Liste des domaines pour l'instance de service.

ibmcloud cis domains

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Effectuez une vérification d'activation sur le domaine spécifié.

ibmcloud cis domain-activation-check DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-g, --group

Afficher les fonctions d'un même groupe. Les valeurs valides pour group sont all, domain, reliability``performance, et security. Cette option est mutuellement exclusive avec -f, --feature.

-f, --feature

Fonction des paramètres de domaine à contrôler. Cette option est mutuellement exclusive avec g, --group. Les valeurs admises sont les suivantes :

• always_use_https: Rediriger toutes les requêtes utilisant le schéma vers http https. Ce paramètre s'applique à toutes les requêtes HTTP adressées au domaine.
• automatic_https_rewrites: Pour corriger le contenu mixte, remplacez http par https pour toutes les ressources ou tous les liens de votre site web pouvant être servis avec HTTPS.
• bot_management: Détectez et limitez le trafic généré par les bots sur votre domaine.
• brotli: Lorsque le client qui demande un élément prend en charge l'algorithme de compression Brotli, CIS fournit une version de cet élément compressée au format Brotli.
• browser_check: Évaluez les en-têtes HTTP provenant du navigateur de vos visiteurs afin de détecter d'éventuelles menaces. Si une menace est détectée, une page de blocage est alors envoyée.
• challenge_ttl: Précisez pendant combien de temps un visiteur dont l’adresse IP a une mauvaise réputation est autorisé à accéder à votre site web après avoir réussi un test de sécurité.
• ciphers: Liste blanche des algorithmes de chiffrement pour la terminaison TLS au format BoringSSL. Cette commande répertorie les chiffrements autorisés par les clients. Si aucun algorithme de chiffrement n'est autorisé, la liste est vide et les algorithmes par défaut sont utilisés. Voir Suites de chiffrement Edge et Suites de chiffrement Origin pour la liste des chiffrements par défaut.
• cname_flattening: Suivre un enregistrement CNAME jusqu'à sa destination et renvoyer cette adresse IP à la place de l'enregistrement CNAME. Par défaut, ne réduisez que le CNAME situé à la racine de votre domaine.
• domain_hold: Les verrous de domaine empêchent les équipes de votre organisation d'ajouter des domaines déjà actifs dans un autre compte. Plans Enterprise uniquement
• email_obfuscation les adresses électroniques de votre page web sont cryptées pour les protéger contre les robots, tout en restant visibles pour les humains.
• opportunistic_onion: Permettez aux utilisateurs légitimes du navigateur Tor d'accéder à vos sites web.
• hotlink_protection: Protégez vos images contre les liens externes.
• http2: Accélérez votre site web grâce à l' HTTP/2.
• http3: Accélérez votre site web grâce à l' HTTP/3.
• image_load_optimization: Déclassé. améliore le temps de chargement des pages comportant des images sur les appareils mobiles ayant des connexions réseau lentes
• image_size_optimization: Améliorez le temps de chargement des images en optimisant celles hébergées sur votre domaine.
• image_resizing le réseau CIS permet de redimensionner, de convertir et d'optimiser à la demande les images servies par le réseau.
• ip_geolocation: Indiquez le code pays correspondant à la localisation du visiteur dans toutes les requêtes adressées à votre site web.
• ipv6: Activer la prise en charge d' IPv6 s et la passerelle.
• max_upload: Nombre de visiteurs pouvant télécharger des données sur votre site web en une seule requête.
• min_tls_version: N'autoriser que les connexions HTTPS provenant de visiteurs prenant en charge la version sélectionnée du protocole TLS ou une version plus récente.
• minify: Réduisez la taille des fichiers de code source sur votre site web.
• mobile_redirect: Rediriger les visiteurs utilisant des appareils mobiles vers un site web optimisé pour les mobiles.
• opportunistic_encryption: Le chiffrement opportuniste permet aux navigateurs de bénéficier des performances améliorées d' HTTP/2, en leur indiquant que votre site est accessible via une connexion chiffrée.
• origin_error_page_pass_thru: Lorsque la page d'erreur d'origine est définie sur On, CIS redirige les pages d'erreur 502 et 504 directement depuis l'origine. Plans d'entreprise uniquement
• origin_max_http_version: Configurez la version HTTP sur Origin.
• origin_post_quantum_encryption: Indique à CIS d'utiliser des algorithmes d'échange de clés post-quantiques (PQ) lorsqu'il se connecte à votre serveur d'origine.
• prefetch_preload: CIS précharge toutes les URL incluses dans l'en-tête prefetch HTTP. Plans Enterprise uniquement
• pseudo_ipv4: Ajoute un en-tête IPv4 aux requêtes lorsqu'un client utilise IPv6, mais que le serveur ne prend en charge que IPv4.
• response_buffering: Activez ou désactivez la mise en mémoire tampon des réponses provenant du serveur d'origine. Plans Enterprise uniquement
• script_load_optimization: Améliorer le temps de chargement des pages contenant des éléments JavaScript.
• security_header: Mettez en place une politique de sécurité Web pour votre site Web.
• security_level: Choisissez le profil de sécurité adapté à votre site web.
• server_side_exclude: Masquer automatiquement certains contenus aux visiteurs suspects.
• tls_client_auth: Certificat client TLS présenté à des fins d'authentification lors de la récupération à la source. Plans Enterprise uniquement
• true_client_ip_header: CIS envoie l'adresse IP de l'utilisateur dans l'en-tête True-Client-IP. Plans Enterprise uniquement
• waf: Un pare-feu d'applications Web (WAF) bloque les requêtes contenant du contenu malveillant.
• websockets: Autorisez les connexions WebSockets vers votre serveur d'origine.
• proxy_read_timeout: Durée maximale entre deux opérations de lecture à partir de l'origine. Plans Enterprise uniquement
• url_normalization: Modifier les URL des requêtes entrantes.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenir les paramètres ciphers du domaine DNS_DOMAIN_ID.

ibmcloud cis domain-settings DNS_DOMAIN_ID -f ciphers

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-f, --feature

Fonctionnalité des paramètres de domaine à mettre à jour. Obligatoire. Valeurs valides :

• always_use_https: Rediriger toutes les requêtes utilisant le schéma vers http https. Cette redirection s'applique à toutes les requêtes HTTP adressées au domaine.
• automatic_https_rewrites: Pour corriger le contenu mixte, remplacez http par https pour toutes les ressources ou tous les liens de votre site web pouvant être servis avec HTTPS.
• bot_management: Détectez et limitez le trafic généré par les bots sur votre domaine.
• brotli: Lorsque le client qui demande un élément prend en charge l'algorithme de compression Brotli, CIS fournit une version de cet élément compressée au format Brotli.
• browser_check: Évaluez les en-têtes HTTP provenant du navigateur de vos visiteurs afin de détecter d'éventuelles menaces. Si une menace est détectée, une page de blocage est alors envoyée.
• challenge_ttl: Précisez pendant combien de temps un visiteur dont l’adresse IP a une mauvaise réputation est autorisé à accéder à votre site web après avoir réussi un test de sécurité.
• ciphers: Liste de chiffrement autorisée pour la terminaison de TLS. Ces chiffrements doivent être au format BoringSSL.
• cname_flattening: Suivre un enregistrement CNAME jusqu'à sa destination et renvoyer cette adresse IP à la place de l'enregistrement CNAME. Par défaut, mettez uniquement à plat le CNAME à la racine de votre domaine.
• domain_hold: Les verrous de domaine empêchent les équipes de votre organisation d'ajouter des domaines déjà actifs dans un autre compte. Plans Enterprise uniquement
• email_obfuscation les adresses électroniques de votre page web sont cryptées pour les protéger contre les robots, tout en restant visibles pour les humains.
• opportunistic_onion: Permettez aux utilisateurs légitimes du navigateur Tor d'accéder à vos sites web.
• hotlink_protection: Protégez vos images contre les liens externes.
• http2: Accélérez votre site web grâce à l' HTTP/2.
• http3: Accélérez votre site web grâce à l' HTTP/3.
• image_load_optimization: Déclassé. améliore le temps de chargement des pages comportant des images sur les appareils mobiles ayant des connexions réseau lentes
• image_size_optimization: Améliorez le temps de chargement des images en optimisant celles hébergées sur votre domaine.
• image_resizing le réseau CIS permet de redimensionner, de convertir et d'optimiser à la demande les images servies par le réseau.
• ip_geolocation: Indiquez le code pays correspondant à la localisation du visiteur dans toutes les requêtes adressées à votre site web.
• ipv6: Activer la prise en charge d' IPv6 s et la passerelle.
• max_upload: Nombre de visiteurs pouvant télécharger des données sur votre site web en une seule requête.
• min_tls_version: N'autoriser que les connexions HTTPS provenant de visiteurs prenant en charge la version sélectionnée du protocole TLS ou une version plus récente.
• minify: Réduisez la taille des fichiers de code source sur votre site web.
• mobile_redirect: Rediriger les visiteurs utilisant des appareils mobiles vers un site web optimisé pour les mobiles.
• opportunistic_encryption: Le chiffrement opportuniste permet aux navigateurs de bénéficier des performances améliorées d' HTTP/2, en leur indiquant que votre site est accessible via une connexion chiffrée.
• origin_error_page_pass_thru: Lorsque l'option Page d'erreur d'origine est définie sur On, CIS redirige les pages d'erreur 502 et 504 directement depuis l'origine. Plans d'entreprise uniquement
• origin_max_http_version: Configurez la version HTTP sur Origin.
• origin_post_quantum_encryption: Indique à CIS d'utiliser des algorithmes d'échange de clés post-quantiques (PQ) lorsqu'il se connecte à votre serveur d'origine.
• prefetch_preload: CIS précharge toutes les URL incluses dans l'en-tête prefetch HTTP. Plans Enterprise uniquement
• pseudo_ipv4: Ajoute un en-tête IPv4 aux requêtes lorsqu'un client utilise IPv6, mais que le serveur ne prend en charge que IPv4.
• response_buffering: Activez ou désactivez la mise en mémoire tampon des réponses provenant du serveur d'origine. Plans Enterprise uniquement
• script_load_optimization: Améliorer le temps de chargement des pages contenant des éléments JavaScript.
• security_header: Mettez en place une politique de sécurité Web pour votre site Web.
• security_level: Choisissez le profil de sécurité adapté à votre site web.
• server_side_exclude: Masquer automatiquement certains contenus aux visiteurs suspects.
• tls_client_auth: Certificat client TLS présenté à des fins d'authentification lors de la récupération à la source. Plans Enterprise uniquement
• true_client_ip_header: CIS envoie l'adresse IP de l'utilisateur dans l'en-tête True-Client-IP. Plans Enterprise uniquement
• waf: Un pare-feu d'applications Web (WAF) bloque les requêtes contenant du contenu malveillant.
• websockets: Autorisez les connexions WebSockets vers votre serveur d'origine.
• proxy_read_timeout: Durée maximale entre deux opérations de lecture à partir de l'origine.
• url_normalization: Modifier les URL des requêtes entrantes.

-v, --value

Valeur définie avec la fonction pour le domaine. Obligatoire.

• Les valeurs valides pour always_use_https sont et on off.

• Les valeurs valides pour automatic_https_rewrites sont et on off.

• Les valeurs valides pour bot_management sont « use_latest_model », « fight_mode », « session_score », « enable_js ». Par exemple, -v fight_mode=true,session_score=true

  • use_latest_model: Permet d'activer ou non la dernière version du modèle. Les valeurs valides pour use_latest_model sont et true false.
  • fight_mode mode de combat : Permet d'activer ou non le mode de combat. Les valeurs valides pour fight_mode sont et true false.
  • session_score: Permet d'activer ou non le score de la session. Les valeurs valides pour session_score sont et true false.
  • enable_js: Permet d'activer les détections de JavaScript. Les valeurs valides pour enable_js sont et true false.

• Les valeurs valides pour browser_check sont et on off.

• Les valeurs valides pour challenge_ttl sont 300, 900, 1800, 2700, 3600, 7200, 10800, 14400, 28800, 57600, 86400, 604800, 2592000, 31536000.

• Les valeurs valides pour cname_flattening sont flatten_at_root, flatten_all.

  • flatten_at_root: Simplifier le CNAME au niveau du domaine racine. Cette valeur est la valeur par défaut.
  • flatten_all: Supprimez tous les enregistrements CNAME de votre domaine.

• Les valeurs valables pour domain_hold sont hold, include_subdomains et hold_after.

  • hold: Permet d'activer ou non la mise en attente du domaine. Les valeurs valides pour hold sont et true false.
  • include_subdomains: Activer ou non la suspension du domaine. Les valeurs valides pour include_subdomains sont et true false.
  • hold_after: Si hold_after est fourni, la suspension est temporairement désactivée, puis automatiquement réactivée par le système à l'heure spécifiée.

  Pour les domaines et sous-domaines enable : -v hold=true,include_subdomains=true. Pour désactiver la mise en attente du domaine : -v hold=false,hold_after=2023-05-31T15:56:36+00:00.

• Les valeurs valides pour hotlink_protection sont on, off.

• Les valeurs valides pour email_obfuscation sont on, off.

• Les valeurs valides pour opportunistic_onion sont on, off.

• Les valeurs valides pour http2 sont on, off.

• Les valeurs valides pour http3 sont on, off.

• Obsolète. Les valeurs valides pour image_load_optimization sont on, off.

• Les valeurs valides pour image_resizing sont on, off.

• Les valeurs valides pour image_size_optimization sont off, lossless, lossy.

  • off : désactive l'optimisation de la taille d'image.
  • lossless: Réduire la taille des fichiers image sans nuire à la qualité visuelle.
  • lossy: La taille des fichiers image JPEG est réduite grâce à une compression avec perte, ce qui peut entraîner une baisse de la qualité visuelle.

• Les valeurs valides pour ip_geolocation sont on, off.

• Les valeurs valides pour ipv6 sont on, off.

• Les valeurs valides (en Mo) pour max_upload sont les suivantes : 100, 125, 150, 175, 200 and 225, 250, 275, 300, 325, 350, 375, 400, 425, 450, 475, 500. Plans d'entreprise uniquement

• Les valeurs valides pour min_tls_version sont 1.0, 1.1, 1.2, 1,3.

• Les valeurs valides pour minify sont css, html, js. Par exemple, -v css=on,html=off,js=on

  • css: Minifier automatiquement l'ensemble du code CSS de votre site web. Les valeurs valides pour css sont on, off.
  • html: Minifier automatiquement tout le code HTML de votre site web. Les valeurs valides pour html sont on, off.
  • js: Minifiez automatiquement tous les fichiers JS de votre site web. Les valeurs valides pour js sont on, off.

• Les valeurs valides pour mobile_redirect sont status, mobile_subdomain, strip_uri. Par exemple, -v status=on,mobile_subdomain=m,strip_uri=true

  • status: Indique si la redirection mobile est activée. Les valeurs valides pour status sont et on off.
  • mobile_subdomain: Préfixe de sous-domaine vers lequel vous souhaitez rediriger les visiteurs sur appareils mobiles (le sous-domaine doit exister).
  • strip_uri: Faut-il supprimer le chemin d'accès actuel à la page et rediriger vers la racine du sous-domaine mobile URL? Les valeurs valides pour strip_uri sont true, false.

• Les valeurs valides pour opportunistic_encryption sont on, off.

• Les valeurs valides pour origin_error_page_pass_thru sont 1, 2.

• Les valeurs valides pour origin_max_http_version sont supported, preferred, off.

  • supported: Les algorithmes post-quantiques sont présentés, mais ne sont utilisés que sur demande de l'origine.
  • preferred: L'option Preferred indique à CIS d'envoyer, si l'occasion se présente, un partage de clés post-quantique (PQ) dans le premier message destiné à l'origine (pour des connexions plus rapides lorsque l'origine prend en charge et privilégie le PQ).
  • off: Les algorithmes post-quantiques ne font pas l'objet d'une promotion.

• Les valeurs valides pour origin_post_quantum_encryption sont on, off.

• Les valeurs valides pour brotli sont on, off.

• Les valeurs valides pour prefetch_preload sont on, off.

• Les valeurs valides pour pseudo_ipv4 sont off, add_header, overwrite_header.

  • off : désactive Pseudo IPv4.
  • add_header: Ajouter uniquement un en-tête supplémentaire Cf-Pseudo-IPv4.
  • overwrite_header : remplace les en-têtes Cf-Connecting-IP et X-Forwarded-For existants par une pseudo adresse IPv4.

• Les valeurs valides pour response_buffering sont on, off.

• Les valeurs valides pour script_load_optimization sont on, off.

• Les valeurs valides pour security_header sont enabled, max_age, include_subdomains, preload, nosniff. Par exemple, -v enabled=true,max_age=100,include_subdomains=true,preload=true,nosniff=true

  • enabled: L'en-tête de sécurité est activé ou non. Les valeurs valides pour enabled sont true, false.
  • max_age: Indiquez la durée (en secondes) pendant laquelle les en-têtes de sécurité sont mis en cache dans les navigateurs.
  • include_subdomains: Chaque domaine situé sous ce domaine hérite du même en-tête de sécurité. Les valeurs valides pour include_subdomains sont true, false.
  • preload: Faut-il autoriser les navigateurs à précharger la configuration security_header? Les valeurs valides pour enabled sont true, false.
  • nosniff: Faut-il envoyer X-Content-Type-Options: nosniff l'en-tête? Les valeurs valides pour nosniff sont true, false.

• Les valeurs valides pour server_level sont off, essentially_off, low, medium, high, under_attack.

• Les valeurs valides pour server_side_exclude sont on, off.

• Les valeurs valides pour tls_client_auth sont on, off.

• Les valeurs valides pour true_client_ip_header sont on, off.

• Les valeurs valides pour waf sont on, off.

• Les valeurs valides pour websockets sont on, off.

• Valeurs valides pour proxy_read_timeout, 1-6000, par défaut : 100.

• Les valeurs valides pour ciphers sont 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. Par exemple, -v AES256-SHA256,AES256-SHA, en utilisant -v default pour réinitialiser les suites de chiffrement configurées à la valeur par défaut.

• Les valeurs valides pour url_normalization sont « type », « scope ». Par exemple, -v type=cis,scope=both

  • type: Permet de sélectionner le type de normalisation URL effectuée par CIS. Les valeurs valides pour type sont cis, rfc3986.
  • scope: Configure la portée de la normalisation de l' URL. Les valeurs valides pour scope sont both, incoming.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Activer tls_client_auth pour le domaine DNS_DOMAIN_ID.

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

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Répertorier toutes les actions d'Edge Functions.

ibmcloud cis edge-functions-actions

Options de commande

--name

Nom de l'action. Plans d'entreprise uniquement

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Afficher les détails de l'action Edge Functions ACTION_NAME.

ibmcloud cis edge-functions-action --name ACTION_NAME

Options de commande

--name

Nom de l'action. Plans d'entreprise uniquement

--javascript-str

Chaîne Javascript. Exemple: addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Fichier Javascript.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créer une action Edge Functions.

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

Options de commande

--name

Nom de l'action. Plans d'entreprise uniquement

--javascript-str

Chaîne Javascript. Exemple: addEventListener('fetch', event => { event.respondWith(fetch(event.request))})

--javascript-file

Fichier Javascript.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mettre à jour une action Edge Functions.

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

Options de commande

--name

Nom de l'action. Plans d'entreprise uniquement

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer l'action Edge Functions ACTION_NAME.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Répertorier tous les déclencheurs Edge Functions pour le domaine DNS_DOMAIN_ID.

ibmcloud cis edge-functions-triggers DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

TRIGGER_ID

L'identifiant du déclencheur. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Afficher les détails du déclencheur Edge Functions TRIGGER_ID.

ibmcloud cis edge-functions-trigger DNS_DOMAIN_ID TRIGGER_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

PATTERN_URL

L' URL de la requête, qui déclenche l'action. Obligatoire.

name

Nom de l'action à laquelle le déclencheur créé est associé. Plans d'entreprise uniquement

disable

Désactiver un déclencheur Edge Functions.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créer un déclencheur Edge Functions pour le domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

TRIGGER_ID

L'identifiant du déclencheur. Obligatoire.

PATTERN_URL

L' URL de la requête, qui déclenche l'action. Obligatoire.

name

Le nom de l'action à laquelle le déclencheur créé est associé. Plans d'entreprise uniquement

disable

Désactiver un déclencheur Edge Functions.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mise à jour du déclencheur Edge Functions TRIGGER_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

TRIGGER_ID

L'identifiant du déclencheur. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer le déclencheur Edge Functions TRIGGER_ID.

ibmcloud cis edge-functions-trigger-delete DNS_DOMAIN_ID TRIGGER_ID

Options de commande

-t, --type

Types de règles de pare-feu à créer. Valeurs valides : access-rules, ua-rules, lockdowns. Obligatoire.

• access-rules : Les règles d'accès permettent d'autoriser, de soumettre à une demande authentification ou de bloquer des demandes vers votre site Web. Vous pouvez appliquer les règles d'accès à un seul domaine ou à tous les domaines d'une instance de service.
• ua-rules : Permet d'effectuer un contrôle d'accès en cas de correspondance avec l'agent utilisé signalé par le client. Les mécanismes de contrôle d'accès peuvent être définis dans une règle pour aider à gérer le trafic de clients particuliers. Cette option vous permet de personnaliser l'accès à votre site.
• lockdowns : Permet de verrouiller l'accès aux URL de ce domaine uniquement aux adresses ou aux plages d'adresses autorisées.

-d, --domain

ID domaine DNS. Pour les règles de type ua-rules et lockdowns, il s'agit d'un paramètre obligatoire.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire une règle de pare-feu. Obligatoire.

• Pour : --type access-rules les données JSON décrivant une règle d'accès au pare-feu comme suit.
  • Les zones obligatoires sont mode, configuration.
    • mode: Type d’action à effectuer. Les valeurs valides sont block, challenge, whitelist, et js_challenge.
    • configuration: Paire cible/valeur à utiliser pour cette règle.
      • target: La propriété de la requête à cibler. Les valeurs valides sont ip, ip_range, asn, et country.
      • value: Valeur correspondant à la cible sélectionnée.
        • Pour ip, la valeur est une adresse IP valide.
        • Pour ip_range, la valeur spécifie une plage d'adresses IP comprise entre et /16 /24.
        • Pour asn, la valeur correspond à un numéro AS.
        • Pour un pays, la valeur correspond au code pays de ce pays.
  • La zone d'option est notes.
    • notes: Quelques informations utiles concernant cette règle afin d'en comprendre l'objectif.

Exemple de données 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"
   }
}

• Pour : --type ua-rules les données JSON qui décrivent une règle d'agent utilisateur comme suit.
  • Les zones obligatoires sont mode, configuration.
    • mode: Type d’action à effectuer. Les valeurs valables sont block, challenge, et js_challenge.
    • configuration: Paire cible/valeur à utiliser pour cette règle.
      • target: La propriété de la requête à cibler. La valeur valide est ua.
      • value: Chaîne exacte UserAgent à faire correspondre avec cette règle.
  • Les zones d'option sont paused, description.
    • paused: Indique si cette règle est actuellement désactivée.
    • description: Quelques informations utiles concernant cette règle afin d'en comprendre l'objectif.

Exemple de données 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"
   }
}

• Pour --type lockdowns: Les données JSON qui décrivent une règle de verrouillage sont les suivantes.
  • Les zones obligatoires sont urls, configurations.
    • urls: URL à inclure dans cette définition de règle.
      • Les caractères génériques sont acceptés.
      • Le masque d'URL saisi ici est mis en échappement avant utilisation.
      • Ce champ limite l' URL à de simples motifs avec caractères génériques.
    • configurations: Liste des adresses IP ou des plages CIDR à utiliser pour cette règle.
      • Ce champ peut contenir un nombre illimité de configurations ip ou ip_range permettant d'accéder aux URL fournies.
      • target: La propriété de la requête à cibler. Les valeurs valables sont ip, et ip_range.
      • value: adresses IP ou CIDR. Si la cible est ip, alors la valeur doit être une adresse IP, sinon un CIDR.
  • Les zones d'option sont paused, description.
    • paused: Indique si cette règle est actuellement désactivée.
    • description: Quelques informations utiles concernant cette règle afin d'en comprendre l'objectif.

Exemple de données 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

Obsolète. Données JSON décrivant une règle de pare-feu.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créez des règles de pare-feu.

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

Options de commande

• FIREWALL_RULE_ID : ID de la règle de pare-feu. Obligatoire.

-t, --type

Le type de règle de pare-feu à créer. Les valeurs valables sont access-rules, ua-rules, et lockdowns. Obligatoire.

• access-rules: Les règles d'accès permettent d'autoriser, de vérifier ou de bloquer les requêtes adressées à votre site web. Vous pouvez appliquer les règles d'accès à un seul domaine ou à tous les domaines d'une instance de service.
• ua-rules: Effectuer un contrôle d'accès en vérifiant la correspondance exacte avec l' UserAgent s fournies par le client. Les mécanismes de contrôle d'accès peuvent être définis dans une règle pour aider à gérer le trafic de clients particuliers. Vous pouvez ainsi personnaliser l'accès à votre site.
• lockdowns: Limitez l'accès aux URL de ce domaine aux seules adresses ou plages d'adresses autorisées.

-d, --domain

ID domaine DNS. Pour les règles de type ua-rules et lockdowns, il s'agit d'un paramètre obligatoire.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire une règle de pare-feu. Obligatoire.

• Pour --type access-rules: Les données JSON qui décrivent une règle d'accès au pare-feu sont les suivantes.
  • Les zones d'option sont mode, notes.
    • mode: Type d’action à effectuer. Les valeurs valides sont block, challenge, whitelist, et js_challenge.
    • notes: Quelques informations utiles concernant cette règle afin d'en comprendre l'objectif.

Exemple de données JSON :

{
   "mode": "challenge",
   "notes": "This rule is added because of event X that occurred on date xyz",
}

• Pour --type ua-rules: Les données JSON qui décrivent une règle de user-agent sont les suivantes.

  • Les zones obligatoires sont mode, configuration.
    • mode: Type d’action à effectuer. Les valeurs valables sont block, challenge, et js_challenge.
    • configuration: Paire cible/valeur à utiliser pour cette règle.
      • target: La propriété de la requête à cibler. La valeur valide est ua.
      • value: Chaîne exacte UserAgent à faire correspondre avec cette règle.
  • Les zones d'option sont paused, description.
    • paused: Indique si cette règle est actuellement désactivée.
    • description: Quelques informations utiles concernant cette règle afin d'en comprendre l'objectif.

  Exemple de données 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"
   }
}

• Pour --type lockdowns: Les données JSON qui décrivent une règle de verrouillage sont les suivantes.
  • Les zones obligatoires sont urls, configurations.
    • urls: URL à inclure dans cette définition de règle.
      • Les caractères génériques sont acceptés.
      • Le masque d'URL saisi ici est mis en échappement avant utilisation.
      • Ce champ limite l' URL à de simples motifs avec caractères génériques.
    • configurations: Liste des adresses IP ou des plages CIDR à utiliser pour cette règle.
      • Ce champ peut contenir un nombre illimité de configurations ip ou ip_range permettant d'accéder aux URL fournies.
      • target: La propriété de la requête à cibler. Les valeurs valables sont ip et ip_range.
      • value: adresses IP ou CIDR. Si la cible est ip, alors la valeur doit être une adresse IP, sinon un CIDR.
  • Les zones d'option sont paused, description.
    • paused: Indique si cette règle est actuellement désactivée.
    • description: Quelques informations utiles concernant cette règle afin d'en comprendre l'objectif.

Exemple de données 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

Obsolète. Les données JSON décrivant une règle de pare-feu.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mettez à jour les règles de pare-feu.

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"}]}'

Options de commande

-t, --type

Le type de règle de pare-feu à créer. Les valeurs valables sont access-rules, ua-rules, et lockdowns. Obligatoire.

• access-rules: Les règles d'accès permettent d'autoriser, de vérifier ou de bloquer les requêtes adressées à votre site web. Vous pouvez appliquer les règles d'accès à un seul domaine ou à tous les domaines d'une instance de service.
• ua-rules: Effectuer un contrôle d'accès en vérifiant la correspondance exacte avec l' UserAgent s fournies par le client. Les mécanismes de contrôle d'accès peuvent être définis dans une règle pour aider à gérer le trafic de clients particuliers. Cette action vous permet de personnaliser l'accès à votre site.
• lockdowns: Limitez l'accès aux URL de ce domaine aux seules adresses ou plages d'adresses autorisées.

-d, --domain

ID domaine DNS. Pour les règles de type ua-rules et lockdowns, il s'agit d'un paramètre obligatoire.

--page

Nombre de pages de résultats paginés. La valeur par défaut est 0.

--per-page

Nombre maximal de règles d'accès par page. La valeur minimale est 5. La valeur par défaut est 20.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Répertoriez les règles de pare-feu.

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

Options de commande

FIREWALL_RULE_ID

L'identifiant de la règle de pare-feu. Obligatoire.

-t, --type

Type de règle de pare-feu à créer. Les valeurs valables sont access-rules, ua-rules, et lockdowns.

• access-rules: Les règles d'accès permettent d'autoriser, de vérifier ou de bloquer les requêtes adressées à votre site web. Vous pouvez appliquer les règles d'accès à un seul domaine ou à tous les domaines d'une instance de service.
• ua-rules: Effectuer un contrôle d'accès en vérifiant la correspondance exacte avec l' UserAgent s fournies par le client. Les mécanismes de contrôle d'accès peuvent être définis dans une règle pour aider à gérer le trafic de clients particuliers. Vous pouvez ainsi personnaliser l'accès à votre site.
• lockdowns: Limitez l'accès aux URL de ce domaine aux seules adresses ou plages d'adresses autorisées.

-d, --domain

ID domaine DNS. Pour les règles de type ua-rules et lockdowns, il s'agit d'un paramètre obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenez les détails d'une règle de pare-feu.

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

Options de commande

FIREWALL_RULE_ID

L'identifiant de la règle de pare-feu. Obligatoire.

-t, --type

Type de règle de pare-feu à créer. Les valeurs valables sont access-rules, ua-rules, et lockdowns. Obligatoire.

• access-rules: Les règles d'accès permettent d'autoriser, de vérifier ou de bloquer les requêtes adressées à votre site web. Vous pouvez appliquer les règles d'accès à un seul domaine ou à tous les domaines d'une instance de service.
• ua-rules: Effectuer un contrôle d'accès en vérifiant la correspondance exacte avec l' UserAgent s fournies par le client. Les mécanismes de contrôle d'accès peuvent être définis dans une règle pour aider à gérer le trafic de clients particuliers. Ce champ vous permet de personnaliser l'accès à votre site.
• lockdowns: Limitez l'accès aux URL de ce domaine aux seules adresses ou plages d'adresses autorisées.

-d, --domain

ID domaine DNS. Pour les règles de type ua-rules et lockdowns, il s'agit d'un paramètre obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimez une règle de pare-feu.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--page

Nombre de pages de résultats paginés. La valeur par défaut est 1.

--per-page

Nombre de règles de pare-feu par page. La valeur minimale est 5 et la valeur maximale est 100. La valeur par défaut est 25.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Liste des règles de pare-feu existantes dans le domaine DNS_DOMAIN_ID.

ibmcloud cis firewall-rules DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

FIREWALL_RULE_ID

L'ID de la règle de pare-feu. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenir les détails de la règle de pare-feu FIREWALL_RULE_ID.

ibmcloud cis firewall-rule DNS_DOMAIN_ID FIREWALL_RULE_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--expression

Expression de filtre. Par exemple, ip.src eq 93.184.216.0.

--action

Action de règle à effectuer. Les valeurs valides sont log, allow, challenge, js_challenge, blocket bypass.

--priority

Priorité de la règle. Les valeurs valides vont de à 0 2147483647. La valeur 0 doit être définie sur la valeur par défaut.

--description

Pour décrire brièvement la règle.

--paused

Indique si la règle est active ou non. Les valeurs valides sont on et off. La valeur par défaut est off.

--products

Liste des produits de sécurité à contourner. Les valeurs valides sont zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, et waf.

--json

Fichier JSON ou chaîne JSON utilisé pour décrire une règle de pare-feu.

• Les champs obligatoires dans les données JSON sont expression et action.
  • expression: Une expression de filtrage. Par exemple, ip.src eq 93.184.216.0
  • action: Action à effectuer dans le cadre de la règle. Les valeurs valides sont log, allow, challenge, js_challenge, block, et bypass.
• Les zones facultatives sont description, priority, paused, products.
  • description: Décrire brièvement la règle.
  • priority: Priorité de la règle. Les valeurs valides vont de à 0 2147483647. La valeur 0 doit être définie sur la valeur par défaut.
  • paused: Indique si la règle est active ou non. Les valeurs valables sont on et off. La valeur par défaut est off.
  • products: Liste des produits de sécurité à contourner. Les valeurs valides sont zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, et. Par waf exemple : --products zoneLockdown, rateLimit

Exemple de données 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

Obsolète. Les données JSON qui décrivent une règle de pare-feu.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créer une règle de pare-feu dans le domaine 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"}'

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

FIREWALL_RULE_ID

L'ID de la règle de pare-feu. Obligatoire.

--expression

Expression de filtre. Par exemple, ip.src eq 93.184.216.0.

--action

Action de règle à effectuer. Les valeurs valides sont log, allow, challenge, js_challenge, blocket bypass.

--priority

Priorité de la règle. Les valeurs valides vont de à 0 2147483647. La valeur 0 doit être définie sur la valeur par défaut.

--description

Pour décrire brièvement la règle.

--paused

Indique si la règle est active ou non. Les valeurs valides sont on et off. La valeur par défaut est off.

--products

Liste des produits de sécurité à contourner. Les valeurs valides sont zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, et waf.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire une règle de pare-feu.

• Les champs obligatoires dans les données JSON sont expression, et action.
  • expression: Une expression de filtrage. Par exemple, ip.src eq 93.184.216.0
  • action: Action à effectuer dans le cadre de la règle. Les valeurs valides sont log, allow, challenge, js_challenge, block, et bypass.
• Les zones facultatives sont description, priority, paused, products.
  • description: Décrire brièvement la règle.
  • priority: Priorité de la règle. Les valeurs valides vont de à 0 2147483647. La valeur 0 doit être définie sur la valeur par défaut.
  • paused: Indique si la règle est active ou non. Les valeurs valables sont on et off. La valeur par défaut est off.
  • products: Liste des produits de sécurité à contourner. Les valeurs valides sont zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, et. Par waf exemple : --products zoneLockdown, rateLimit

Les champs description, priority, et paused, qui ne sont pas explicitement définis dans les données JSON sont remplacés par la valeur par défaut.

Exemple de données 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

Obsolète. Les données JSON qui décrivent une règle de pare-feu.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mise à jour de la règle de pare-feu 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"}'

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

FIREWALL_RULE_ID

L'ID de la règle de pare-feu. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer la règle de pare-feu FIREWALL_RULE_ID.

ibmcloud cis firewall-rule-delete DNS_DOMAIN_ID FIREWALL_RULE_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

EXPRESSION

L'expression de filtre. Par exemple, ip.src eq 93.184.216.0. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Valider l'expression de la règle de pare-feu.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire un équilibreur de charge global. Obligatoire.

• Les champs obligatoires dans les données JSON sont name, et fallback_pool: default_pools
  • name: Le nom d'hôte DNS à associer à votre équilibreur de charge.
  • fallback_pool: L'ID du pool à utiliser lorsque tous les autres pools sont détectés comme défaillants.
  • default_pools: Liste des identifiants de pool classés par ordre de priorité de basculement.
• Les zones facultatives sont description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy :
  • description: Description de votre équilibreur de charge.
  • ttl : durée de vie de l'entrée DNS pour l'adresse IP renvoyée par cet équilibreur de charge.
  • region_pools: Correspondance entre les codes de région et de pays et une liste d'identifiants de pool (classés par ordre de priorité de basculement) pour la région.
  • proxied: Déterminez si le trafic doit transiter par les fonctions de sécurité et de performance d' CIS.
  • enabled: Activer ou non (c'est le réglage par défaut) cet équilibreur de charge.
  • session_affinity le serveur d'arrière-plan : Il garantit que les demandes d'un utilisateur sont toujours dirigées vers le même serveur d'arrière-plan au cours d'une session. Les valeurs valables sont cookie et none.
  • session_affinity_ttl: Durée, en secondes, avant l'expiration du cookie d'affinité de session de cet équilibreur de charge après sa création. La valeur valide est comprise entre [1800, 604800]. La valeur par défaut est 82800.
  • steering_policy: Les valeurs valides pour steering_policy sont off, geo, random, dynamic_latency.
    • off: Utiliser default_pools.
    • geo: Utiliser region_pools/pop_pools.
    • random: Sélectionnez un pool au hasard.
    • dynamic_latency: Utilisez le temps aller-retour pour sélectionner le pool le plus proche ( default_pools nécessite des contrôles d'intégrité du pool).

Exemple de données 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

Obsolète. Données JSON décrivant un équilibreur de charge global.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créer un équilibreur de charge global dans le domaine 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"]}}'

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

GLB_ID

L'identifiant du répartiteur de charge global. Obligatoire.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire un équilibreur de charge global. Obligatoire.

• Les champs obligatoires dans les données JSON sont name, fallback_pool, et : default_pools
  • name: Le nom d'hôte DNS à associer à votre équilibreur de charge.
  • fallback_pool: L'ID du pool à utiliser lorsque tous les autres pools sont détectés comme défaillants.
  • default_pools: Liste des identifiants de pool classés par ordre de priorité de basculement.
• Les zones facultatives sont description, ttl, region_pools, proxied, enabled, session_affinity, session_affinity_ttl, steering_policy :
  • description: Description de votre équilibreur de charge.
  • ttl: Durée de vie (TTL) de l'entrée DNS correspondant à l'adresse IP renvoyée par cet équilibreur de charge.
  • region_pools: Correspondance entre les codes de région et de pays et une liste d'identifiants de pool (classés par ordre de priorité de basculement) pour la région.
  • proxied: Déterminez si le trafic doit transiter par les fonctions de sécurité et de performance d' CIS.
  • enabled: Activer ou non (c'est le réglage par défaut) cet équilibreur de charge.
  • session_affinity le serveur d'arrière-plan : Il garantit que les demandes d'un utilisateur sont toujours dirigées vers le même serveur d'arrière-plan au cours d'une session. Les valeurs valables sont cookie et none.
  • session_affinity_ttl: Durée, en secondes, avant l'expiration du cookie d'affinité de session de cet équilibreur de charge, à compter de sa création. La valeur valide est comprise entre [1800, 604800]. La valeur par défaut est 82800.
  • steering_policy: Les valeurs valides pour steering_policy sont off, geo, random, dynamic_latency.
    • off: Utiliser default_pools.
    • geo: Utiliser region_pools/pop_pools.
    • random: Sélectionnez un pool au hasard.
    • dynamic_latency: Utilisez le temps aller-retour pour sélectionner le pool le plus proche ( default_pools nécessite des contrôles d'intégrité du pool).

Exemple de données 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

Obsolète. Données JSON décrivant un équilibreur de charge global.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mettre à jour l'équilibreur de charge global GLB_ID dans le domaine DNS_DOMAIN_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"]}}'

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

GLB_ID

L'identifiant du répartiteur de charge global. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Afficher l'équilibreur de charge global GLB_ID dans le domaine DNS_DOMAIN_ID.

ibmcloud cis glb DNS_DOMAIN_ID GLB_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

GLB_ID

L'identifiant du répartiteur de charge global. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer l'équilibreur de charge global GLB_ID dans le domaine DNS_DOMAIN_ID.

ibmcloud cis glb-delete DNS_DOMAIN_ID GLB_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Liste des équilibreurs de charge pour le domaine DNS_DOMAIN_ID.

ibmcloud cis glbs DNS_DOMAIN_ID

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Spécifier le format des sorties. Seul JSON est pris en charge.

Exemples

Liste de tous les pools GLB.

ibmcloud cis glb-pools

Options de commande

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire un pool GLB. Obligatoire.

• Les champs obligatoires dans les données JSON sont name, et origins: check_regions
  • name: Nom abrégé (balise) du pool.
  • origins: Liste des origines comprises dans ce pool.
  • check_regions: Liste des codes de régions géographiques.
• Les zones facultatives sont description, minimum_origins, enabled, monitor.

Exemple de données 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

Obsolète. Données JSON utilisées pour décrire un pool GLB.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créer une réserve de 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"]}}]}'

Options de commande

GLB_POOL_ID

L'identifiant du pool de répartiteurs de charge globaux. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Afficher les détails du pool GLB GLB_POOL_ID.

ibmcloud cis glb-pool GLB_POOL_ID

Options de commande

GLB_POOL_ID

L'identifiant du pool de répartiteurs de charge globaux. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer le pool GLB GLB_POOL_ID.

ibmcloud cis glb-pool-delete GLB_POOL_ID

Options de commande

GLB_POOL_ID

L'identifiant du pool de répartiteurs de charge globaux. Obligatoire.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire un pool GLB.

• Les champs obligatoires dans les données JSON sont name, et origins: check_regions
  • name: Nom abrégé (balise) du pool.
  • origins: Liste des origines comprises dans ce pool.
  • check_regions: Liste des codes de régions géographiques.
• Les zones facultatives sont description, minimum_origins, enabled, monitor.

Exemple de données 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

Activer l'origine dans le pool. La valeur peut être ORIGIN_NAME ou ORIGIN_ADDRESS.

--disable-origin

Désactiver l'origine dans le pool. La valeur peut être ORIGIN_NAME ou ORIGIN_ADDRESS.

--add-origin

Ajouter une origine dans le pool. Les valeurs ORIGIN_NAME et ORIGIN_ADDRESS sont obligatoires. Par exemple : --add-origin name=us-app-dal01,address=1.1.1.1,enabled=true,weight=0.5,host=example.com

--remove-origin

Retirer une origine du pool. La valeur peut être ORIGIN_NAME ou ORIGIN_ADDRESS.

-s, --json-str

Obsolète. Données JSON utilisées pour décrire un pool GLB.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mise à jour du pool 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}]}'

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Dressez la liste de tous les moniteurs GLB.

ibmcloud cis glb-monitors

Options de commande

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire un moniteur GLB. Obligatoire.

• La zone obligatoire dans les données JSON est type.
  • type: Protocole à utiliser pour le contrôle de l'état de santé. Les valeurs valables sont HTTP, HTTPS, et TCP.
• Les zones facultatives sont description, timeout, retries, interval.
  • description: Description.
  • timeout: Délai d'expiration (en secondes) avant que le contrôle d'intégrité ne soit marqué comme ayant échoué.
  • retries: Nombre de tentatives à effectuer en cas de délai d'attente avant de marquer l'origine comme défaillante.
  • interval: Intervalle entre chaque contrôle d'intégrité.
• Pour le contrôle de santé de type TCP. La zone obligatoire supplémentaire est port.
  • port: Le port de l' TCP à utiliser pour le contrôle d'intégrité.
• Pour le contrôle de santé de type HTTP/HTTPS. Les zones facultatives supplémentaires sont port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: Le port de l' TCP à utiliser pour le contrôle d'intégrité.
  • expected_body: Sous-chaîne à rechercher dans le corps de la réponse, sans distinction de majuscules/minuscules.
  • expected_codes: Code de réponse ou plage de codes attendus de l' HTTP pour le contrôle d'intégrité.
  • method: La méthode HTTP à utiliser pour le contrôle d'intégrité.
  • path: Chemin d'accès au point de terminaison à soumettre au contrôle d'intégrité.
  • header: Les en-têtes de requête HTTP à envoyer lors du contrôle d'intégrité.
  • follow_redirects: Suivre les redirections si elles sont renvoyées par le serveur d'origine.
  • allow_insecure: Ne validez pas le certificat lorsque vous utilisez l' HTTPS de surveillance.
  • probe_zone: Attribuez ce moniteur pour qu'il émule la zone spécifiée lors de la détection.

Exemple de données JSON :

Pour 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"
}

Pour TCP :

{
      "description": "Health monitor of TCP",
      "type": "tcp",
      "port": 80,
      "timeout": 5,
      "retries": 2,
      "interval": 90
}

-s, --json-str

Obsolète. Données JSON utilisées pour décrire un moniteur GLB.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créer un contrôleur des 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}'

Options de commande

GLB_MON_ID

L'identifiant du moniteur de l'équilibreur de charge global. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Afficher les détails du moniteur GLB GLB_MON_ID.

ibmcloud cis glb-monitor GLB_MON_ID

Options de commande

GLB_MON_ID

ID du moniteur d'équilibreur de charge global. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer le moniteur GLB GLB_MON_ID.

ibmcloud cis glb-monitor-delete GLB_MON_ID

Options de commande

GLB_MON_ID

L'identifiant du moniteur de l'équilibreur de charge global. Obligatoire.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire un moniteur GLB. Obligatoire.

• La zone obligatoire dans les données JSON est type.
  • type: Protocole à utiliser pour le contrôle de l'état de santé. Les valeurs valables sont HTTP, HTTPS, et TCP.
• Les zones facultatives sont description, timeout, retries, interval.
  • description: Description.
  • timeout: Délai d'expiration (en secondes) avant que le contrôle d'intégrité ne soit marqué comme ayant échoué.
  • retries: Nombre de tentatives à effectuer en cas de délai d'attente avant de marquer l'origine comme défaillante.
  • interval: Intervalle entre chaque contrôle d'intégrité.
• Pour le contrôle de santé de type TCP. La zone obligatoire supplémentaire est port.
  • port: Le port de l' TCP à utiliser pour le contrôle d'intégrité.
• Pour le contrôle de santé de type HTTP/HTTPS. Les zones facultatives supplémentaires sont port, expected_body, expected_codes, method, path, header, follow_redirects, allow_insecure.
  • port: Le port de l' TCP à utiliser pour le contrôle d'intégrité.
  • expected_body: Sous-chaîne à rechercher dans le corps de la réponse, sans distinction de majuscules/minuscules.
  • expected_codes: Code de réponse ou plage de codes attendus de l' HTTP pour le contrôle d'intégrité.
  • method: La méthode HTTP à utiliser pour le contrôle d'intégrité.
  • path: Chemin d'accès au point de terminaison à soumettre au contrôle d'intégrité.
  • header: Les en-têtes de requête HTTP à envoyer lors du contrôle d'intégrité.
  • follow_redirects: Suivre les redirections si elles sont renvoyées par le serveur d'origine.
  • allow_insecure: Ne validez pas le certificat lorsque vous utilisez l' HTTPS de surveillance.
  • probe_zone: Attribuez ce moniteur pour qu'il émule la zone spécifiée lors de la détection.

Exemple de données JSON :

Pour 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"
}

Pour TCP :

{
      "description": "Health monitor of TCP",
      "type": "tcp",
      "port": 80,
      "timeout": 5,
      "retries": 2,
      "interval": 90
}

-s, --json-str

Obsolète. Données JSON utilisées pour décrire un moniteur GLB.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mettre à jour le moniteur 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}'

Options de commande

-s, --since

Date de début de la période des données demandées au format ISO8601. Par exemple,2018-11-26.

-u, --until

Date de fin de la période des données demandées au format ISO8601. Par exemple,2018-11-28.

--origin-name

Nom de l'origine pour laquelle filtrer.

--pool-name

Nom du pool pour lequel filtrer.

--origin-healthy

Si la condition est vraie, filtrez les événements dont l'état d'origine est normal; si elle est fausse, filtrez les événements dont l'état d'origine est anormal. La valeur par défaut est true et les valeurs valides sont true et false.

--pool-healthy

Si la condition est vraie, filtrez les événements pour lesquels l'état du pool est sain; si elle est fausse, filtrez les événements pour lesquels l'état du pool est défaillant. La valeur par défaut est true et les valeurs valides sont true et false.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenir des événements glb.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--fields

Définissez l'ensemble de champs à renvoyer.

• Ce champ doit être renseigné sous la forme d'une liste séparée par des virgules, sans espaces, et tous les champs doivent être renseignés.
• L'ordre dans lequel les zones sont spécifiées n'a pas d'importance, et l'ordre des zones dans la réponse n'est pas défini.
• Les champs doivent être sensibles à la casse.

--filter

Filtres permettant d'explorer des événements spécifiques. Les filtres se composent de trois parties : la clé, l'opérateur et la valeur. Pour plus d'informations sur les opérateurs pris en charge, voir Utilisation des champs, des fonctions et des expressions.

--sample

La fréquence d'échantillonnage des enregistrements définie par le client : 1 sample correspond à 100 % des enregistrements.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

-h, --help

Obtenir de l'aide sur cette commande.

Exemples

Créer un journal instantané pour le domaine DNS_DOMAIN_ID:

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

Voici trois exemples de filtres :

• Filtrer lorsque le pays de l'adresse IP du client n'est pas le Canada :

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

• Filtre lorsque le code de statut renvoyé par CIS est 200 ou 201 :

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

• Filtrer lorsque le chemin de la requête contient « /static » et que le nom d'hôte de la requête est « example.com » :

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

-h, --help

Aide sur cette commande.

Exemple

Obtenir la tâche de journaux instantanés pour le domaine DNS_DOMAIN_ID:

ibmcloud cis instant-log-get DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemple

ibmcloud cis leaked-credential-checks status-get DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--enabled

Indique si les vérifications des identifiants divulgués sont activées pour le domaine DNS. Les valeurs valides sont true et false.

--json

Fichier JSON ou chaîne JSON décrivant la configuration des vérifications des identifiants compromis. Le champ obligatoire est enabled.

{
  "enabled": true
}

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemple

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

DETECTION_ID

L'identifiant de la détection personnalisée des identifiants compromis. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemple

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--username

L'expression de règle qui identifie le nom d'utilisateur dans une requête. Obligatoire lorsque n'est --json pas utilisé.

--password

L'expression de règle qui identifie le mot de passe dans une requête. Obligatoire lorsque n'est --json pas utilisé.

--json

Fichier JSON ou chaîne JSON décrivant la détection personnalisée. Les champs obligatoires sont username et password.

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

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

DETECTION_ID

L'identifiant de la détection personnalisée des identifiants compromis. Obligatoire.

--username

L'expression de règle qui identifie le nom d'utilisateur dans une requête.

--password

L'expression de règle qui identifie le mot de passe dans une requête.

--json

Fichier JSON ou chaîne JSON décrivant la détection personnalisée. Les champs facultatifs sont et username password; indiquez-en au moins un.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

DETECTION_ID

L'identifiant de la détection personnalisée des identifiants compromis. Obligatoire.

-f, --force

Supprimer la détection sans demander de confirmation.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemple

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

RAY_ID

L'identifiant Ray de la requête. Obligatoire.

--fields

Liste, séparée par des virgules, des champs de journal (sensibles à la casse) à renvoyer.

--timestamps

Format des champs d'horodatage. Les valeurs valables sont unix, unixnano, et rfc3339. La valeur par défaut est unix.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--available-fields

Liste de toutes les zones disponibles.

--ray-id

Rechercher des journaux par ID Ray spécifique.

--fields

Définissez l'ensemble de champs à renvoyer. Ce champ doit être renseigné sous la forme d'une liste séparée par des virgules, sans espaces, et tous les champs doivent être renseignés. L'ordre dans lequel les zones sont spécifiées n'a pas d'importance, et l'ordre des zones dans la réponse n'est pas défini. Notez que les zones sont censées être sensibles à la casse.

--start

Début (inclusif) de la période demandée. Il peut s'agir d'un horodatage unix (en secondes ou en nanosecondes) ou d'un horodatage absolu conforme à la norme RFC 3339. Actuellement, la date ne peut pas remonter à plus de 7 jours. La valeur par défaut est de 65 minutes plus tôt.

--end

Fin (exclusive) de la période demandée. Cette valeur peut être un horodatage Unix (en secondes ou en nanosecondes) ou un horodatage absolu conforme à la norme RFC 3339. La date de fin (end) doit être au moins 5 minutes plus tôt que maintenant et ne doit pas être postérieure à la date de début (start). La différence entre et start ne end doit pas dépasser 1h. Par défaut, l'heure est avancée de 5 minutes.

--count

Nombre de journaux à récupérer. La valeur par défaut est -1.

--sample

Pourcentage d'échantillonnage. Lorsqu'un échantillon est fourni, un échantillon d'enregistrements correspondants est renvoyé. Si sample=0.1 alors 10 % des enregistrements sont renvoyés. L'échantillonnage est aléatoire : des appels répétés renvoient non seulement des enregistrements différents, mais le nombre d'enregistrements renvoyés est également susceptible de varier légèrement. Si count est également spécifié, il est appliqué au nombre d'enregistrements renvoyés, et non aux enregistrements échantillonnés. Ainsi, avec sample=0.05 et count=7, lorsqu'il y a au total 100 enregistrements disponibles, environ 5 enregistrements sont renvoyés. Sur 1 000 enregistrements, 7 sont renvoyés. Sur 10 000 enregistrements, 7 sont renvoyés. La valeur par défaut est 1.

--timestamps

Définissez le format dans lequel les horodatages de réponse sont renvoyés. Les valeurs valides sont unix, unixnano et rfc3339.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--destination

Spécifier une destination où les données sont poussées. Pour plus d'informations sur les destinations prises en charge, voir Gestion des tâches Logpush.

• Syntaxe du chemin d'accès à « Cloud Object Storage » : cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>&ibm_api_key=<API_KEY>' Exemple : 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX' Pour classer les journaux dans des sous-dossiers quotidiens, utilisez la chaîne spéciale dans {DATE} le chemin d'accès au compartiment. Il est remplacé par la date au format YYYYMMDD 20190423, par exemple. Des sous-dossiers sont créés selon les besoins, par exemple : 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cd&ibm_api_key=XXX'

--name

Nom du travail. Obligatoire.

--enable

Activer la tâche. Par défaut, il est déactivé.

--fields

Définir la liste des zones de journal à inclure dans les fichiers journaux. Plusieurs champs peuvent être séparés par des virgules. Utilisez la commande [ibmcloud cis logpush-available-fields DNS_DOMAIN_ID] pour obtenir la liste complète des champs de journal disponibles, ou utilisez all pour inclure tous les champs disponibles dans les fichiers journaux. Notez que les zones sont censées être sensibles à la casse.

--timestamps

Définissez le format dans lequel les horodatages de réponse sont renvoyés. Les valeurs valides sont unix, unixnano et rfc3339.

--dataset

La catégorie de journaux que vous souhaitez recevoir. Cette valeur ne peut pas être modifiée une fois le travail créé. Les valeurs valides sont http_requests, range_events, firewall_events, dns_logs. La valeur par défaut est http_requests.

--frequency

Fréquence à laquelle CIS envoie des lots de journaux à votre destination. Si vous réglez la fréquence sur élevée, vos journaux seront envoyés en plus grand nombre, sous forme de fichiers plus petits. Régler la fréquence sur faible permet d'envoyer des journaux en plus petites quantités, mais sous forme de fichiers plus volumineux. Les valeurs valides sont high, low.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créer une tâche logpush pour le domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--destination

Spécifier une destination où les données sont poussées. Pour plus d'informations sur les destinations prises en charge, voir Gestion des tâches Logpush. Syntaxe du chemin d'accès à « Cloud Object Storage » : cos://<BUCKET_OBJECT_PATH>?region=<REGION>&instance-id=<IBM_ClOUD_OBJECT_STORAGE_INSTANCE_ID>ibm_api_key=<API_KEY> Exemple : 'cos://cis-test-bucket/logs?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX' Pour séparer les journaux en sous-dossiers quotidiens, utilisez la chaîne spéciale {DATE} dans le chemin du compartiment. Il doit être remplacé par la date au format YYYYMMDD 20190423, par exemple. Des sous-dossiers sont créés selon les besoins, par exemple : 'cos://cis-test-bucket/logs/{DATE}?region=us&instance-id=f75e6d90-4212-4026-851c-d572071146cdibm_api_key=XXX'

--enable

Activer la tâche. Par défaut, il est déactivé.

--fields

Définir la liste des zones de journal à inclure dans les fichiers journaux. Les zones multiples peuvent être séparées par des virgules et vous pouvez utiliser la commande ibmcloud cis logpush-available-fields DNS_DOMAIN_ID pour obtenir la liste complète des zones de journal disponibles ou utiliser all pour inclure toutes les zones disponibles dans les fichiers journaux. Notez que les zones sont censées être sensibles à la casse.

--timestamps

Définissez le format dans lequel les horodatages de réponse sont renvoyés. Les valeurs valides sont unix, unixnano, rfc3339.

--dataset

La catégorie de journaux que vous souhaitez recevoir. Cette valeur ne peut pas être modifiée une fois le travail créé. Les valeurs valides sont http_requests, range_events, firewall_events,dns_logs. La valeur par défaut est http_requests.

--jobid

JOB_ID est l'identifiant du job logpush.

--frequency

Fréquence à laquelle CIS envoie des lots de journaux à votre destination. Si vous réglez la fréquence sur élevée, vos journaux seront envoyés en plus grand nombre, sous forme de fichiers plus petits. Régler la fréquence sur faible permet d'envoyer des journaux en plus petites quantités, mais sous forme de fichiers plus volumineux. Les valeurs valides sont high et low.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mise à jour de la tâche logpush de range_events pour le domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

-output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenir tous les travaux de logpush pour le domaine DNS_DOMAIN_ID.

ibmcloud cis logpush-jobs DNS_DOMAIN_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--dataset

La catégorie de journaux que vous souhaitez recevoir. Cette valeur ne peut pas être modifiée une fois le travail créé. Les valeurs valides sont http_requests, range_events, firewall_events,dns_logs. La valeur par défaut est http_requests.

--jobid

JOB_ID est l'identifiant du job logpush.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenir les détails du travail de http_requests logpush.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--dataset

La catégorie de journaux que vous souhaitez recevoir. Cette valeur ne peut pas être modifiée une fois le travail créé. Les valeurs valides sont http_requests, range_events, firewall_events,dns_logs. La valeur par défaut est http_requests.

--jobid

JOB_ID est l'identifiant du job logpush.

-f, --force

Supprimer la tâche logpush sans demander de confirmation.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer http_requests logpush job for domain DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--dataset

La catégorie de journaux que vous souhaitez recevoir. Cette valeur ne peut pas être modifiée une fois le travail créé. Les valeurs valides sont http_requests, range_events, firewall_events,dns_logs. La valeur par défaut est http_requests.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Obtenez toutes les zones disponibles pour les journaux http_requests.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenir un paramètre de conservation des journaux pour le domaine DNS_DOMAIN_ID.

ibmcloud cis log-retention DNS_DOMAIN_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--flag

Activer ou désactiver la conservation des journaux. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Activer la conservation des journaux pour le domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--dataset

Jeu de données demandé. La valeur par défaut est firewallEventsAdaptiveGroups.

Utilisez le tableau suivant pour identifier les jeux de données inclus dans votre plan et la plage de données d'historique que vous pouvez interroger.

Ensembles de données inclus dans votre plan

Jeu de données	Essai / Standard / Standard-Next	Entreprise / Sécurité / GLB
firewallEventsAdaptiveGroups	30 jours	30 jours
firewallEventsAdaptive	30 jours	30 jours

--filter

Filtrer les événements. La valeur par défaut correspond aux 6 dernières heures de données.

Les opérateurs suivants sont pris en charge pour toutes les options de filtre :

Opérateurs pris en charge pour les options de filtre

Opérateur	Comparaison
gt	supérieur à
il	inférieur à
geq	supérieur ou égal à
leq	inférieur à
neq	non égal
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

Ordre de tri. (La valeur par défaut est datetime_ASC)

La liste suivante répertorie les options de commande utilisables pour le fichier correspondant et toutes les options de commande prennent en charge les actions ASC et DESC. Combinez ces options de filtre et l'action avec _.

Par exemple, datetime_ASC trier par date et heure, par ordre croissant.

• Options d'ordre 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

Le nombre d'événements à renvoyer. (minimum : 1, maximum : 10000, par défaut : 10000)

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenez des analyses des événements de pare-feu pour le domaine 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--dataset

Jeu de données demandé. La valeur par défaut est httpRequests1dGroups. Utilisez le tableau suivant pour identifier les jeux de données inclus dans votre plan et la plage de données d'historique que vous pouvez interroger.

Identifier les ensembles de données inclus dans votre plan

Jeu de données	Essai / Standard / Standard-next	Entreprise / Sécurité / GLB
httpRequests1dGroups	365 jours	365 jours
httpRequests1hGroups	30 jours	90 jours
httpRequests1mGroups	3 jours	7 jours

--filter

Filtrer les événements. La valeur par défaut correspond aux données des 7 derniers jours. Les opérateurs suivants sont pris en charge pour toutes les options de filtre :

Opérateurs pris en charge pour les options de filtre

Opérateur	Comparaison
gt	supérieur à
il	inférieur à
geq	supérieur ou égal à
leq	inférieur à
neq	non égal
in	in

• Options de filtre httpRequests1dGroups et httpRequests1hGroups.

  • date

• Options de filtre httpRequests1mGroups.

  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--order

Ordre de tri. (La valeur par défaut est datetime_ASC)

La liste suivante répertorie les options de commande utilisables pour le fichier correspondant et toutes les options de commande prennent en charge les actions ASC et DESC. Combinez ces options d'ordre et l'action avec _.

Par exemple, date_ASC trier par date croissante.

• Options d'ordre communes à chaque jeu de données HTTP.
  • orderByParams
  • date
  • sum_bytes
  • sum_cachedBytes
  • sum_cachedRequests
  • sum_requests
• Options d'ordre httpRequests1dGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
• Options d'ordre httpRequests1hGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
• Options d'ordre httpRequests1mGroups.
  • avg_bytes
  • sum_encryptedBytes
  • sum_encryptedRequests
  • sum_pageViews
  • sum_threats
  • uniq_uniques
  • datetime
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeFifteenMinutes
  • datetimeHour
  • datetimeDay

--limit

Le nombre d'événements à renvoyer. (minimum : 1, maximum : 10000, par défaut : 10000)

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenir des analyses des requêtes HTTP pour le domaine 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--recent

Début de la période demandée. Les valeurs valides sont 6h (il y a 6 heures), 12h, 1d (il y a 1 jour), 1w (il y a 1 semaine), 1m (il y a 1 mois), 2m, 3m. La valeur par défaut est 1w.

-t, --table

Sortie sous forme de table. Les valeurs valides sont requests, bandwidth, uniques, et threats status_code. Si ce champ n'est pas défini, toutes les tables sont éditées.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenir des statistiques d'audience pour le domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

DIMENSION

La dimension interrogée. Les valeurs valides sont queries-by-response-code, queries-by-type, queries-by-name. Obligatoire.

-s, --since

Temps écoulé jusqu'à maintenant. Les valeurs valides sont ( 6h il y a 6 heures), 12h, 1d (il y a 1 jour), 1w (il y a 1 semaine).

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenez des analyses DNS pour le domaine DNS_DOMAIN_ID.

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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--recent

Début de la période demandée. Les valeurs valides sont 6h (il y a 6 heures), 12h, 1d (il y a 1 jour), 1w (il y a 1 semaine), 1m (il y a 1 mois), 2m, 3m. La valeur par défaut est 1w.

--time-delta

Intervalle (en secondes) de l'enregistrement de chaque analyse. Les valeurs valides sont 60, 3600, 86400, 2592000. La valeur par défaut est 3600.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenir des analyses sur les limites de débit pour le domaine DNS_DOMAIN_ID.

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

Options de commande

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Activer la mutualisation TLS.

ibmcloud cis access-enable

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Répertorier tous les certificats d'origine pour le domaine DNS_DOMAIN_ID.

ibmcloud cis origin-certificates DNS_DOMAIN_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--request-type REQUEST_TYPE

Type de signature que vous souhaitez voir figurer sur le certificat. Les valeurs valides sont origin-rsa et origin-ecc.

--hostnames HOSTNAME

le nom d'hôte ou le nom générique lié au certificat.

--requested-validity DAYS

Nombre de jours pendant lesquels le certificat doit être valide. La valeur par défaut est 5475.

--csr CSR

Demande de signature de certificat (CSR). Si ce champ n'est pas défini, CIS en génère un.

--json value*

Fichier JSON ou chaîne JSON utilisé(e) pour décrire un certificat d'origine.

• Les zones obligatoires dans les données JSON sont request_type, hostnames.
  • request_type type de signature : Type de signature que vous souhaitez voir figurer sur le certificat. Les valeurs valides sont origin-rsa, origin-ecc.
  • hostnames: Ensemble de noms d'hôtes ou de noms génériques associés au certificat.
• Les zones facultatives sont requested_validity, csr.
  • requested_validity: Nombre de jours pendant lesquels le certificat doit être valide. Les valeurs valides sont 0, 7, 30, 90, 365, 730, 1095, 5475.
  • csr: La demande de signature de certificat (CSR). Si ce champ n'est pas défini, CIS en génère un.

Exemple de données JSON :

{
   "request_type": "origin-rsa",
   "hostnames": [
      "*.example.com",
      "example.com",
],
   "requested_validity": 5475,
   "csr": "your_csr"
}

-s, --json-str

Obsolète. Les données JSON décrivant un certificat d'origine.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créer un certificat signé par l' CIS pour le domaine 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

CERT_ID

L'ID du certificat d'origine. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Obtenir des informations détaillées sur le certificat d'origine CERT_ID.

ibmcloud cis origin-certificate DNS_DOMAIN_ID CERT_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

CERT_ID

L'identifiant du certificat d'origine. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer le certificat d'origine CERT_ID.

ibmcloud cis origin-certificate-delete DNS_DOMAIN_ID CERT_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Afficher les informations générales sur le domaine DNS_DOMAIN_ID.

ibmcloud cis overview DNS_DOMAIN_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--json

Fichier JSON ou chaîne JSON utilisé pour décrire une règle de page. Obligatoire.

• Les champs obligatoires dans les données JSON sont les cibles et les actions :
  • targets: Le modèle d' URL s cible à évaluer lors d'une requête.
  • actions: Ensemble d'actions à effectuer si les cibles de cette règle correspondent à la requête. Les actions disponibles sont :
    • 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
    • Déclassé. image_load_optimization.
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Certaines actions sont réservées aux formules 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
• Les champs facultatifs sont et priority: status
  • priority: un chiffre indiquant la priorité d'une règle de page par rapport à une autre. La valeur par défaut est 1.
  • status: Statut de la règle de la page. Les valeurs valides sont active et ( disabled par défaut).

Exemple de données 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

Obsolète. Données JSON décrivant une règle de page.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Créer une règle de page pour le domaine 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

PAGE_RULE_ID

L'identifiant de la règle de page. Obligatoire.

--json VALUE

Fichier JSON ou chaîne JSON utilisé pour décrire une règle de page. Obligatoire.

• Les champs obligatoires dans les données JSON sont targets et : actions
  • targets: Le modèle d' URL s cible à évaluer lors d'une requête.
  • actions: Ensemble d'actions à effectuer si les cibles de cette règle correspondent à la requête. Les actions disponibles sont :
    • 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
    • Déclassé. image_load_optimization
    • image_size_optimization
    • script_load_optimization
    • host_header_override
    • resolve_override
    • Certaines actions sont réservées aux formules 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
• Les champs facultatifs sont et priority: status
  • priority: Chiffre indiquant la priorité accordée à une règle de mise en page par rapport à une autre. La valeur par défaut est 1.
  • status: Règle relative au statut de la page. Les valeurs valables sont active et disabled. La valeur par défaut est disabled.

Exemple de données 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

Obsolète. Données JSON décrivant une règle de page.

-j, --json-file

Obsolète. Un fichier contient des données JSON d'entrée.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Mettre à jour la règle de la page 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

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

PAGE_RULE_ID

L'identifiant de la règle de page. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

Exemples

Supprimer la règle de la page PAGE_RULE_ID.

ibmcloud cis page-rule-delete DNS_DOMAIN_ID PAGE_RULE_ID

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

Répertorier toutes les règles de page du domaine DNS_DOMAIN_ID.

ibmcloud cis page-rules DNS_DOMAIN_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

PAGE_RULE_ID

L'identifiant de la règle de page. Obligatoire.

-i, --instance

Nom ou ID de l'instance. Si le nom ou l'ID de l'instance n'est pas défini, l'instance de contexte spécifiée par ibmcloud cis instance-set INSTANCE est utilisée.

--output

Format de sortie. Actuellement, json est la seule valeur prise en charge.

Exemples

En savoir plus sur les règles de page PAGE_RULE_ID.

ibmcloud cis page-rule DNS_DOMAIN_ID PAGE_RULE_ID --output json

Options de commande

DNS_DOMAIN_ID

L'ID du domaine DNS. Obligatoire.

--name

Nom de l'enregistrement DNS pour l'application range.

--edge-port

Configuration des ports à la périphérie de CIS. La valeur par défaut est 22.

--origin-direct

Adresses de destination pour l'origine.

--origin-lb-name

Nom de l'équilibreur de charge associé à l'application range.

--origin-lb-port

Le port du répartiteur de charge associé à l'application range. La valeur par défaut est 22.

--protocol

Type de protocole. Les valeurs valides sont tcp et udp. La prise en charge du protocole UDP est en accès anticipé, demandez un UDP personnalisé depuis le tableau de bord CIS avant de créer une application UDP Range. La valeur par défaut est tcp.

--proxy-protocol

Activer le protocole de proxy jusqu'à l'origine. Les valeurs valides sont on, off, v1, v2, simple. La valeur par défaut est off. Obsolète. La valeur on est équivalente à v1.

--ip-firewall

Permet de contrôler si le pare-feu IP est activé pour cette application. Les valeurs valides sont on et off. La valeur par défaut est off.

--edge-connectivity

Versions IP prises en charge pour les connexions entrantes sur une plage d'adresses IP anycast. Les valeurs valides sont all, ipv4, ipv6. La valeur par défaut est all.

--edge-tls

Type de terminaison TLS associée à l'application. Les valeurs valides sont off, flexible, full, strict. La valeur par défaut est off.

--traffic-type

Détermine comment les données transitent de la périphérie à votre origine. Les valeurs valides sont direct, http, https. La valeur par défaut est direct.

--json

Fichier JSON ou chaîne JSON utilisé(e) pour décrire une application de plage.

• Les champs obligatoires dans les données JSON sont protocol et dns.
  • protocol: Configuration des ports au niveau de la périphérie d' CIS.
  • dns: Le nom et le type de l'enregistrement DNS pour la demande de plage.
    • name: Nom de l'enregistrement DNS pour l'application de plage.
    • type: Type d’enregistrement DNS associé à l’application. La valeur valide est CNAME.
• Les champs facultatifs sont origin_direct, origin_dns, origin_port, proxy_protocol, ip_firewall, edge_ips, tls, et traffic_type.
  • origin_direct: Une liste des adresses de destination par rapport à l'origine.
  • origin_dns: Méthode et paramètres utilisés pour déterminer l'adresse du serveur d'origine via le DNS.
    • name: nom de l'enregistrement DNS.
  • origin_port: Le port de destination à l'origine.
  • proxy_protocol: Activez le protocole proxy vers l'origine. Les valeurs valides sont on, off, v1, v2, simple. La valeur par défaut est off. Obsolète. La valeur on est équivalente à v1.
  • ip_firewall firewall : Contrôle si le pare-feu IP est activé pour cette application. Les valeurs valables sont on et off.
  • edge_ips: Configuration IP de périphérie Anycast pour le nom d'hôte de cette application.
    • type: Type de configuration IP en périphérie spécifié. Les IP de périphérie allouées dynamiquement utilisent des IP anycast Range en fonction de la connectivité spécifiée. La valeur valide est dynamic.
    • connectivity: Versions IP prises en charge pour les connexions entrantes sur une plage d'adresses IP anycast. Valeurs valides : all, ipv4, ipv6.
  • tls : type d'arrêt TLS associé à l'application. Les valeurs valides sont off, flexible, full, et strict.
  • traffic_type: Détermine comment les données transitent de la périphérie vers votre origine. Lorsqu'il est défini sur direct, range achemine le trafic directement vers votre origine, et le type de l'application est dérivé du protocole. Lorsqu’elle est définie sur ou http https, la plage s’applique aux fonctionnalités HTTP () / HTTPS () d’ CIS lors de l’acheminement du trafic vers votre origine, et le type d’application correspond exactement à cette propriété. Les valeurs valides sont direct, http, et https. La valeur par défaut est direct.