Plugin ServiceNow pour l'échange de risques

Ce document explique comment configurer le plugin ServiceNow v2.0.0 avec le module Risk Exchange de la plateforme Netskope Cloud Exchange. Ce plugin extrait les utilisateurs de la table sys_user (Sécurité du système > Utilisateurs et groupes > Utilisateurs), les périphériques de la table cmdb_ci_computer (Configuration > Élément de base > Ordinateurs) et les applications de la table cmdb_ci_business_app (Organisation > Applications métier) de la plateforme ServiceNow. Il prend en charge les actions Ajouter/Supprimer un utilisateur d’un groupe, Ajouter/Supprimer un utilisateur d’un rôle, Mettre à jour la délégation d’un utilisateur, Gérer les balises des périphériques, Gérer les balises des applications et Partager les données des applications.

Conditions préalables

Pour réaliser cette intégration, vous avez besoin de :

• Un locataire Netskope (ou plusieurs, par exemple des instances de production et de développement/test).
• Un locataire Netskope Cloud Exchange avec le plugin Tenant et le plugin Risk Exchange déjà configurés.
• Connectivité à une instance ServiceNow : https://<instanceid>.service-now.com/

Support du plugin ServiceNow

Ce plug-in récupère les utilisateurs de la table sys_user (Sécurité du système > Utilisateurs et groupes > Utilisateurs), les périphériques de la table cmdb_ci_computer (Configuration > Élément de base > Ordinateurs) et les applications de la table cmdb_ci_business_app (Organisation > Applications métier) de la plateforme ServiceNow. Il prend en charge les actions Ajouter/supprimer un utilisateur d’un groupe, Ajouter/supprimer un utilisateur d’un rôle, Mettre à jour la délégation utilisateur, Gérer les balises de périphériques, Gérer les balises d’applications et Partager les données d’une application.

Mises en correspondance

Mappages d'extraction pour les utilisateurs

Mappages de traction pour les applications

Mappings de traction pour périphérique

Cartographie par poussée

Le message suivant sera ajouté au champ 'notes' de la table 'core_company' sur la plateforme ServiceNow.

[Netskope CE] Last shared at: <sharing_time>Application Name: <application_name>, Cloud Confidence Index: <cci>, CCL: <ccl>, Category Name: <category_name>, Deep Link: <deep_link>

Les champs d'application suivants sont partagés :

Permissions

Vous trouverez ci-dessous la liste des ACL requises pour utiliser le plugin ServiceNow :

Rôles requis :

• cmdb_read
• snc_internal
• sn_cmdb_editor
• user_admin
• rôle personnalisé avec les autorisations ACL répertoriées ci-dessus 

{
  "result": [
    {
      "sys_id": {
        "display_value": "005d500b536073005e0addeeff7b12f4",
        "value": "005d500b536073005e0addeeff7b12f4"
      },
      "email": {
        "display_value": "survey.user@email.com",
        "value": "survey.user@email.com"
      },
      "user_name": {
        "display_value": "survey.user",
        "value": "survey.user"
      },
      "name": {
        "display_value": "survey user",
        "value": "survey user"
      },
      "failed_attempts": {
        "display_value": "0",
        "value": "0"
      },
      "password_needs_reset": {
        "display_value": "false",
        "value": "false"
      },
      "active": {
        "display_value": "true",
        "value": "true"
      },
      "last_login_time": {
        "display_value": "2019-04-05 15:16:30",
        "value": "2019-04-05 22:16:30"
      },
      "vip": {
        "display_value": "false",
        "value": "false"
      },
      "business_criticality": {
        "display_value": "3 - Non-critical",
        "value": "3"
      },
      "internal_integration_user": {
        "display_value": "false",
        "value": "false"
      },
      "web_service_access_only": {
        "display_value": "false",
        "value": "false"
      },
      "identity_type": {
        "display_value": "-",
        "value": "unclassified"
      },
      "federated_id": {
        "display_value": "UU/OJDA/H2viaQb8VqlJIYSYKwmbkOCLoFDQkTPv7XM=",
        "value": "UU/OJDA/H2viaQb8VqlJIYSYKwmbkOCLoFDQkTPv7XM="
      },
      "manager.email": {
        "display_value": "",
        "value": ""
      },
      "company.name": {
        "display_value": "",
        "value": ""
      },
      "department.name": {
        "display_value": "",
        "value": ""
      },
      "source": {
        "display_value": "",
        "value": ""
      }
    }
  ]
}

{
  "result": [
    {
      "sys_id": {
        "display_value": "00a96c0d3790200044e0bfc8bcbe5db4",
        "value": "00a96c0d3790200044e0bfc8bcbe5db4"
      },
      "name": {
        "display_value": "MacBook Pro 15\"",
        "value": "MacBook Pro 15\""
      },
      "serial_number": {
        "display_value": "ABE-486-V17263-DO",
        "value": "ABE-486-V17263-DO"
      },
      "ip_address": {
        "display_value": "",
        "value": ""
      },
      "mac_address": {
        "display_value": "",
        "value": ""
      },
      "fqdn": {
        "display_value": "",
        "value": ""
      },
      "dns_domain": {
        "display_value": "",
        "value": ""
      },
      "life_cycle_stage": {
        "display_value": "",
        "value": ""
      },
      "life_cycle_stage_status": {
        "display_value": "",
        "value": ""
      },
      "warranty_expiration": {
        "display_value": "",
        "value": ""
      },
      "attested": {
        "display_value": "false",
        "value": "false"
      },
      "attestation_status": {
        "display_value": null,
        "value": ""
      },
      "attestation_score": {
        "display_value": "",
        "value": ""
      },
      "unverified": {
        "display_value": "false",
        "value": "false"
      },
      "virtual": {
        "display_value": "false",
        "value": "false"
      },
      "fault_count": {
        "display_value": "0",
        "value": "0"
      },
      "environment": {
        "display_value": null,
        "value": ""
      },
      "discovery_source": {
        "display_value": null,
        "value": ""
      },
      "asset_tag": {
        "display_value": "P1000503",
        "value": "P1000503"
      },
      "assigned_to.email": {
        "display_value": "eduardo.bellendir@example.com",
        "value": "eduardo.bellendir@example.com"
      },
      "managed_by": {
        "display_value": "",
        "value": ""
      },
      "most_frequent_user": {
        "display_value": "",
        "value": ""
      },
      "owned_by": {
        "display_value": "",
        "value": ""
      }
    }
  ]
}

{
  "result": [
    {
      "sys_id": {
        "display_value": "5d935f86835e8b104f7556a6feaad35b",
        "value": "5d935f86835e8b104f7556a6feaad35b"
      },
      "name": {
        "display_value": "CrowdStrike",
        "value": "CrowdStrike"
      },
      "asset_tag": {
        "display_value": "",
        "value": ""
      },
      "short_description": {
        "display_value": "",
        "value": ""
      },
      "comments": {
        "display_value": "[Netskope CE] Last shared at: 2026-07-27 07:22:09Z\nApplication Name: CrowdStrike, Cloud Confidence Index: 1, CCL: low, Category Name: NetskopeAPP, Deep Link: netskope.com\n",
        "value": "[Netskope CE] Last shared at: 2026-07-27 07:22:09Z\nApplication Name: CrowdStrike, Cloud Confidence Index: 1, CCL: low, Category Name: NetskopeAPP, Deep Link: netskope.com\n"
      },
      "url": {
        "display_value": "https://app.netskope.example/app/CrowdStrike",
        "value": "https://app.netskope.example/app/CrowdStrike"
      },
      "vendor.name": {
        "display_value": "",
        "value": ""
      },
      "manufacturer.name": {
        "display_value": "",
        "value": ""
      },
      "category": {
        "display_value": "XDR",
        "value": "XDR"
      },
      "subcategory": {
        "display_value": "",
        "value": ""
      },
      "business_criticality": {
        "display_value": null,
        "value": ""
      },
      "data_classification": {
        "display_value": null,
        "value": ""
      },
      "operational_status": {
        "display_value": "Operational",
        "value": "1"
      },
      "install_status": {
        "display_value": "In Production",
        "value": "1"
      },
      "life_cycle_stage.name": {
        "display_value": null,
        "value": ""
      },
      "life_cycle_stage_status.name": {
        "display_value": null,
        "value": ""
      },
      "product_support_status": {
        "display_value": null,
        "value": ""
      },
      "certified": {
        "display_value": "false",
        "value": "false"
      },
      "attested": {
        "display_value": "false",
        "value": "false"
      },
      "attestation_status": {
        "display_value": "Not Yet Reviewed",
        "value": "Not Yet Reviewed"
      },
      "attestation_score": {
        "display_value": "",
        "value": ""
      },
      "environment": {
        "display_value": null,
        "value": ""
      },
      "application_type": {
        "display_value": null,
        "value": ""
      },
      "next_assessment_date": {
        "display_value": "",
        "value": ""
      },
      "active": {
        "display_value": "true",
        "value": "true"
      },
      "owned_by.email": {
        "display_value": "",
        "value": ""
      },
      "managed_by.email": {
        "display_value": "",
        "value": ""
      },
      "it_application_owner.email": {
        "display_value": "",
        "value": ""
      },
      "application_manager.email": {
        "display_value": "",
        "value": ""
      },
      "support_group.name": {
        "display_value": "",
        "value": ""
      },
      "company.name": {
        "display_value": "",
        "value": ""
      },
      "user_base": {
        "display_value": null,
        "value": ""
      },
      "active_user_count": {
        "display_value": "",
        "value": ""
      },
      "discovery_source": {
        "display_value": null,
        "value": ""
      },
      "sys_updated_on": {
        "display_value": "2026-07-28 01:49:06",
        "value": "2026-07-28 08:49:06"
      }
    }
  ]
}

{
  "result": [
    { "sys_id": "019ad92ec7230010393d265c95c260dd", "name": "Analytics Settings Managers" }
  ]
}

{
  "result": [
    { "sys_id": "011ba5aa0a0a0b3001a439c580549134", "name": "role_delegator" }
  ]
}

{
  "result": [
    {
      "sys_id": "005d500b536073005e0addeeff7b12f4",
      "user_name": "survey.user",
      "email": "survey.user@email.com"
    },
    {
      "sys_id": "02826bf03710200044e0bfc8bcbe5d55",
      "user_name": "jimmie.barninger",
      "email": "jimmie.barninger@example.com"
    }
  ]
}

{
  "result": [
    { "sys_id": "019ad92ec7230010393d265c95c260dd", "name": "Analytics Settings Managers" }
  ]
}

{ "name": "<group name>" }

{
  "result": {
    "sys_id": "0b22a56a83d28f104f7556a6feaad354",
    "name": "Netskope-CE-Doc-Test-Group-1785236837",
    "active": "true",
    "exclude_manager": "false",
    "include_members": "false"
  }
}

{
  "result": [
    { "sys_id": "2f22296a83d28f104f7556a6feaad31d" }
  ]
}

{ "user": "<uid>", "group": "<gid>" }

{
  "result": {
    "sys_id": "2f22296a83d28f104f7556a6feaad31d",
    "user": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/005d500b536073005e0addeeff7b12f4",
      "value": "005d500b536073005e0addeeff7b12f4"
    },
    "group": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user_group/0b22a56a83d28f104f7556a6feaad354",
      "value": "0b22a56a83d28f104f7556a6feaad354"
    }
  }
}

204 No Content

{
  "result": [
    { "sys_id": "e4526d6a83d28f104f7556a6feaad3b9" }
  ]
}

{ "user": "<uid>", "role": "<rid>" }

{
  "result": {
    "sys_id": "e4526d6a83d28f104f7556a6feaad3b9",
    "state": "active",
    "inherited": "false",
    "user": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/005d500b536073005e0addeeff7b12f4",
      "value": "005d500b536073005e0addeeff7b12f4"
    },
    "role": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user_role/011ba5aa0a0a0b3001a439c580549134",
      "value": "011ba5aa0a0a0b3001a439c580549134"
    },
    "granted_by": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user_group/not-applicable",
      "value": "not-applicable"
    }
  }
}

204 No Content

{
  "result": [
    { "sys_id": "2462a1aa83d28f104f7556a6feaad31c" }
  ]
}

{
  "user": "<uid>",
  "delegate": "<did>",
  "starts": "<start date>",
  "ends": "<end date>",
  "approvals": "true",
  "assignments": "true",
  "notifications": "true",
  "invitations": "true"
}

{
  "result": {
    "sys_id": "2462a1aa83d28f104f7556a6feaad31c",
    "user": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/005d500b536073005e0addeeff7b12f4",
      "value": "005d500b536073005e0addeeff7b12f4"
    },
    "delegate": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/02826bf03710200044e0bfc8bcbe5d3f",
      "value": "02826bf03710200044e0bfc8bcbe5d3f"
    },
    "starts": "2026-07-28 00:00:00",
    "ends": "2026-08-27 00:00:00",
    "approvals": "true",
    "assignments": "true",
    "notifications": "true",
    "invitations": "true"
  }
}

{
  "approvals": "false",
  "assignments": "true",
  "notifications": "false",
  "invitations": "true"
}

{
  "result": {
    "sys_id": "85ec852f83d687504f7556a6feaad3d3",
    "user": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/005d500b536073005e0addeeff7b12f4",
      "value": "005d500b536073005e0addeeff7b12f4"
    },
    "delegate": {
      "link": "https://your-instance.service-now.com/api/now/table/sys_user/02826bf03710200044e0bfc8bcbe5d55",
      "value": "02826bf03710200044e0bfc8bcbe5d55"
    },
    "starts": "2026-07-31 00:00:00",
    "ends": "2026-08-30 00:00:00",
    "approvals": "false",
    "assignments": "true",
    "notifications": "false",
    "invitations": "true"
  }
}

204 No Content

{
  "result": [
    { "sys_id": "048265aa83d28f104f7556a6feaad378" }
  ]
}

{ "configuration_item": "<ci>", "key": "<key>", "value": "<value>" }

{
  "result": {
    "sys_id": "048265aa83d28f104f7556a6feaad378",
    "configuration_item": {
      "link": "https://your-instance.service-now.com/api/now/table/cmdb_ci/00a96c0d3790200044e0bfc8bcbe5db4",
      "value": "00a96c0d3790200044e0bfc8bcbe5db4"
    },
    "key": "NetskopeCE",
    "value": "Doc-Test-Value"
  }
}

204 No Content

{
  "result": [
    { "sys_id": "048265aa83d28f104f7556a6feaad378" }
  ]
}

{ "configuration_item": "<ci>", "key": "<key>", "value": "<value>" }

{
  "result": {
    "sys_id": "cc9265aa83d28f104f7556a6feaad3e0",
    "configuration_item": {
      "link": "https://your-instance.service-now.com/api/now/table/cmdb_ci/5d935f86835e8b104f7556a6feaad35b",
      "value": "5d935f86835e8b104f7556a6feaad35b"
    },
    "key": "NetskopeCE",
    "value": "Doc-Test-Value"
  }
}

204 No Content

{
  "result": []
}

{
  "name": "<app name>",
  "comments": "<summary block>",
  "discovery_source": "NetskopeCloudExchange"
}

{
  "result": {
    "sys_id": "94a269aa83d28f104f7556a6feaad3f3",
    "name": "Netskope-CE-Doc-Test-App-1785236955",
    "discovery_source": "NetskopeCloudExchange",
    "comments": "[Netskope CE] Last shared at: 2026-07-28 11:00:00Z\nApplication Name: Netskope-CE-Doc-Test-App-1785236955, Cloud Confidence Index: 32, CCL: Poor, Category Name: Cloud Storage, Deep Link: https://example.com/app\n",
    "active": "true",
    "install_status": "1",
    "operational_status": "1"
  }
}

{ "comments": "<summary block>" }

{
  "result": {
    "sys_id": "94a269aa83d28f104f7556a6feaad3f3",
    "name": "Netskope-CE-Doc-Test-App-1785236955",
    "discovery_source": "NetskopeCloudExchange",
    "comments": "[Netskope CE] Last shared at: 2026-07-28 12:00:00Z\nApplication Name: Netskope-CE-Doc-Test-App, Cloud Confidence Index: 45, CCL: Fair, Category Name: Cloud Storage, Deep Link: https://example.com/app\n",
    "sys_mod_count": "1"
  }
}

{
  "result": {
    "sys_id": "0c43b088c6112275011a4bd46a4e6cc4",
    "name": "GenuineIntel",
    "notes": ""
  }
}

{ "notes": "<block(s)>\n\n<existing notes>" }

{
  "result": {
    "sys_id": "0c43b088c6112275011a4bd46a4e6cc4",
    "name": "GenuineIntel",
    "notes": "[Netskope CE] Last shared at: 2026-07-28 12:00:00Z\nApplication Name: Netskope-CE-Doc-Test-App, Cloud Confidence Index: 45, CCL: Fair, Category Name: Cloud Storage, Deep Link: https://example.com/app\n"
  }
}

{
  "batch_request_id": "netskope-ce-<tag>-<chunk_index>",
  "rest_requests": [
    {
      "id": "1",
      "method": "GET",
      "url": "/api/now/table/sys_user_grmember?sysparm_query=user%3D...&sysparm_fields=sys_id&sysparm_limit=1",
      "exclude_response_headers": true,
      "headers": [
        { "name": "Content-Type", "value": "application/json" },
        { "name": "Accept", "value": "application/json" }
      ],
      "body": "<base64 of the JSON body>"
    }
  ]
}

{
  "batch_request_id": "netskope-ce-group-add-1",
  "serviced_requests": [
    { "id": "1", "status_code": 201, "body": "<base64 of the JSON body>" }
  ],
  "unserviced_requests": ["7", "8"]
}

{
  "batch_request_id": "netskope-ce-group-add-1",
  "rest_requests": [
    {
      "id": "1",
      "method": "POST",
      "url": "/api/now/table/sys_user_grmember",
      "headers": [
        { "name": "Content-Type", "value": "application/json" },
        { "name": "Accept", "value": "application/json" }
      ],
      "body": "eyJ1c2VyIjogIjAwNWQ1MDBiNTM2MDczMDA1ZTBhZGRlZWZmN2IxMmY0IiwgImdyb3VwIjogImU1ZDI2MWVhODNkMjhmMTA0Zjc1NTZhNmZlYWFkMzc4In0="
    }
  ]
}

{
  "batch_request_id": "netskope-ce-tag-add-1",
  "rest_requests": [
    {
      "id": "1",
      "method": "POST",
      "url": "/api/now/table/cmdb_key_value",
      "headers": [
        { "name": "Content-Type", "value": "application/json" },
        { "name": "Accept", "value": "application/json" }
      ],
      "body": "eyJjb25maWd1cmF0aW9uX2l0ZW0iOiAiMDBhOTZjMGQzNzkwMjAwMDQ0ZTBiZmM4YmNiZTVkYjQiLCAia2V5IjogIk5ldHNrb3BlQ0UiLCAidmFsdWUiOiAiRG9jLVRlc3QtVmFsdWUifQ=="
    }
  ]
}

{
  "result": {
    "sys_id": "43e2a1ea83d28f104f7556a6feaad346",
    "configuration_item": {
      "link": "https://your-instance.service-now.com/api/now/table/cmdb_ci/00a96c0d3790200044e0bfc8bcbe5db4",
      "value": "00a96c0d3790200044e0bfc8bcbe5db4"
    },
    "key": "NetskopeCE",
    "value": "Doc-Test-Value"
  }
}

{
  "batch_request_id": "netskope-ce-share-app-share-1",
  "rest_requests": [
    {
      "id": "1",
      "method": "POST",
      "url": "/api/now/table/cmdb_ci_business_app",
      "headers": [
        { "name": "Content-Type", "value": "application/json" },
        { "name": "Accept", "value": "application/json" }
      ],
      "body": "<base64 of {\"name\": \"...\", \"comments\": \"...\", \"discovery_source\": \"NetskopeCloudExchange\"}>"
    }
  ]
}

{
  "result": {
    "sys_id": "56f265ea83d28f104f7556a6feaad357",
    "name": "Netskope-CE-Doc-Test-BatchApp-1785237047",
    "discovery_source": "NetskopeCloudExchange",
    "comments": "[Netskope CE] Last shared at: 2026-07-28 11:00:00Z\nApplication Name: Netskope-CE-Doc-Test-BatchApp-1785237047, Cloud Confidence Index: 32, CCL: Poor, Category Name: Cloud Storage, Deep Link: https://example.com/app\n",
    "active": "true",
    "install_status": "1",
    "operational_status": "1"
  }
}

GET /api/now/table/core_company?sysparm_query=<query>&sysparm_fields=sys_id,name,notes

{
  "result": {
    "sys_id": "0c43b088c6112275011a4bd46a4e6cc4",
    "name": "GenuineIntel",
    "notes": ""
  }
}

{ "notes": "<block(s)>\n\n<existing notes>" }

{
  "result": {
    "sys_id": "0c43b088c6112275011a4bd46a4e6cc4",
    "name": "GenuineIntel",
    "notes": "[Netskope CE] Last shared at: 2026-07-28 12:00:00Z\nApplication Name: Netskope-CE-Doc-Test-App, Cloud Confidence Index: 45, CCL: Fair, Category Name: Cloud Storage, Deep Link: https://example.com/app\n"
  }
}

Matrice de performance

Les relevés de performances ci-dessous sont effectués sur un CE à grande pile avec les spécifications de VM mentionnées ci-dessous :

Agent utilisateur

netskope-ce-6.1.0-cre-servicenow-v2.0.0

Workflow

1. Créer un utilisateur et un rôle sur la plateforme ServiceNow.
2. Ajouter des autorisations pour l’utilisateur créé.
3. Créer une source de découverte.
4. Configurez le plugin ServiceNow.
5. Configurer une règle métier de Risk Exchange pour ServiceNow.
6. Configurer les actions Risk Exchange pour ServiceNow.
7. Validez le plugin.

Regardez une vidéo

Cliquer sur « play » pour regarder une vidéo.

Créer un utilisateur sur la plateforme ServiceNow

1. Connectez-vous à ServiceNow.

2. Aller à System Security > Users and Groups > Users.

3. Click New.

   

4. Saisissez les informations requises, copiez l’ID utilisateur et cliquez Submit.

   

5. Après avoir enregistré l’utilisateur, ouvrez sa fiche pour définir le mot de passe et les rôles, puis cliquez sur Set Password.

   

6. Cliquez sur Generate pour créer un nouveau mot de passe, puis copiez-le.

7. Click Save Password.

Créer un rôle sur la plateforme ServiceNow

1. Recherchez les utilisateurs et les groupes dans votre instance ServiceNow, puis cliquez sur Roles.

   

2. On the Roles page, click New.

   

3. Saisissez un nom et une description pour le poste et cliquez sur Submit.

   

4. Créer une ACL. La création d’une ACL peut nécessiter des rôles élevés. Pour activer les rôles élevés, cliquez sur l’icône utilisateur en haut à droite, puis cliquez sur Elevate Role.

   

5. Select security_admin et cliquez sur Update.

   

6. Rechercher le contrôle d’accès (ACL).

   

7. Cliquez sur New pour créer une nouvelle ACL.

   

8. Pour Type, sélectionnez Record, puis saisissez l’opération (par exemple, lire, créer, écrire ou supprimer). Dans Nom, ajoutez le tableau. Fournissez une description de l’ACL en fonction de vos exigences. Dans Rôle requis, ajoutez le nom du rôle créé ci-dessus. Lorsque vous avez terminé, cliquez sur Submit.

   

9. De même, créez des ACL en vous basant sur le tableau fourni dans la section autorisations. Ensuite, attribuez ce rôle à l’utilisateur que vous souhaitez utiliser pour le plug-in CRE ServiceNow.

Ajouter des autorisations à l’utilisateur

1. Accédez à Users et ouvrez les détails de l’utilisateur, puis, dans l’onglet Rôles, cliquez sur Edit.

   

   

2. Ajoutez le rôle que vous avez créé dans la section Créer un rôle sur la plateforme ServiceNow, ainsi que ces rôles (consultez la section Autorisations) :

   • cmdb_read
   • snc_internal
   • sn_cmdb_editor
   • user_admin 

   

3. Click Save.

Créer une source de découverte

Si vous souhaitez extraire et partager les données de l’application avec la table cmdb_ci_business_app, vous devrez créer une source de découverte sur votre instance ServiceNow. Cette source de découverte garantit que l’application que vous avez partagée depuis Cloud Exchange n’est pas réimportée dans Cloud Exchange. Dans certains cas, cela peut entraîner une extraction et un partage cycliques infinis de la même application.

Recherchez les listes de choix, ouvrez la page Listes de choix et cliquez sur New.

To create a new discovery source, add the table cmdb_ci_business_app, then in the element add discovery_source. For Label and Value, enter NetskopeCloudExchange.

Cliquez sur Submit. La valeur NetskopeCloudExchange du champ de source de découverte est utilisée pour empêcher la récupération répétée des applications partagées depuis Netskope Cloud Exchange.

Configurer le plugin ServiceNow

1. Dans Cloud Exchange, allez sur Settings > Plugin Store. Recherchez et sélectionnez le plugin ServiceNow v2.0.0 (CRE).

   

2. Saisissez un nom de configuration et sélectionnez un intervalle de synchronisation.

   

3. Cliquez sur Next et entrez les paramètres de configuration :

   • Instance URL: URL de l’instance ServiceNow (comme https://<your-instance>.service-now.com.
   • Username: Nom d’utilisateur de votre instance ServiceNow.
   • Password: Mot de passe de votre instance ServiceNow.
   • Pull Additional Details: Select les données facultatives à extraire. Les options sélectionnées exposent des champs supplémentaires. Les options non sélectionnées sont ignorées et leurs champs ne sont pas exposés. Notez que, pour toutes les options sélectionnées dans le paramètre, des appels d’API supplémentaires sont effectués pour récupérer les données depuis ServiceNow.

   

4. Cliquez sur Next et sélectionnez l’entité requise dans le menu déroulant Entité. Fournissez le mappage des champs conformément à vos exigences. Vous pouvez en créer une New en cliquant sur Add New Entity.

   

   Pour créer un champ New, cliquez sur Add field.

   

   Indiquez le libellé du champ, le type de données, la normalisation et la stratégie d’agrégation selon vos exigences, puis cliquez sur Save. 

   

   Map the created fields:

   

   

   

   

   

   

   

   

   

   

5. Click Save. Your new plugin configuration appears on the Plugins page.

   

Configurer une règle métier de Risk Exchange pour ServiceNow

1. Dans Risk Exchange, allez sur Business Rules et cliquez sur Create New Rule dans le coin supérieur droit.
2. Saisissez un nom de règle. Select l’entité correspondant aux champs configurés pour les applications sur lesquelles vous devez effectuer l’action, puis configurez la requête selon vos besoins. Cliquez sur Save.

Configurer les actions de Risk Exchange pour ServiceNow

Le plugin ServiceNow prend en charge les actions suivantes :

• Add/Remove User from Group: Cette action peut être utilisée pour ajouter ou supprimer des utilisateurs d’un groupe sur la plateforme ServiceNow.
• Add/Remove User from Role:  Cette action peut être utilisée pour ajouter ou supprimer des rôles pour un utilisateur sur la plateforme ServiceNow.
• Update User Delegation: Cette action peut être utilisée pour mettre à jour la délégation des utilisateurs sur la plateforme ServiceNow. Notez que cette action ne concerne pas plusieurs délégations.
• Manage Device Tags: Cette action peut être utilisée pour ajouter ou supprimer des balises d’un périphérique sur la plateforme ServiceNow.
• Manage Application Tags: Cette action peut être utilisée pour ajouter ou supprimer des tags d’une application sur la plateforme ServiceNow.
• Share Application Data: Cette action peut être utilisée pour partager des applications avec la plateforme ServiceNow.
• No Action: Aucune action ne sera effectuée pour cette action. Les utilisateurs peuvent générer des alertes UBA dans Ticket Orchestrator en utilisant cette action et en activant l'option Générer des alertes.

Ajouter/supprimer un utilisateur d’un groupe

Suivez ces étapes pour configurer l’action Ajouter/Supprimer un utilisateur d’un groupe :

1. Dans Risk Exchange, accédez à Actions et cliquez sur Add Action Configuration.
2. Select la règle de gestion, la configuration et l'action requises dans leur liste déroulante respective.
3. Fournissez les paramètres des actions suivantes :
   • Action Type: Choisissez si vous souhaitez ajouter l'utilisateur au groupe ou l'en retirer. Select dans la liste déroulante du champ Static.
   • Group: Select le groupe ServiceNow auquel ajouter l’utilisateur ou duquel le supprimer, ou cliquez sur Create New Group pour en créer un. La création d’un New groupe n’est prise en charge que lorsque le type d’action est Add to Group.
   • New Group Name: Nom du New groupe. Requis lorsque Create New Group est sélectionné dans le champ Group ; ignoré dans le cas contraire. Indiquez le nom uniquement dans le champ Static. Les champs Source ne sont pas pris en charge.
   • User: Select le champ source ID utilisateur ou E-mail, ou saisissez des valeurs sys_id, e-mail ou nom d’utilisateur séparées par des virgules dans le champ statique.
4. Activez le bouton de bascule Exiger une approbation si une approbation est nécessaire avant d’effectuer une action sur les applications.
5. Cliquez sur Save.

Ajouter/supprimer un utilisateur d’un rôle

Suivez les étapes ci-dessous pour configurer l’action Ajouter/supprimer un utilisateur d’un rôle :

1. Dans Risk Exchange, allez à Actions et cliquez sur Add Action Configuration.
2. Select la règle de gestion, la configuration et l'action requises dans leurs listes déroulantes respectives.
3. Fournissez les paramètres des actions suivantes :
   • Action Type: Indiquez s’il convient d’ajouter l’utilisateur au rôle ou de l’en supprimer. Select une option dans la liste déroulante du champ Static.
   • Role: Select un ou plusieurs rôles ServiceNow auxquels ajouter l’utilisateur ou desquels le retirer. Chaque rôle sélectionné est appliqué à chaque utilisateur indiqué dans le champ User. La création d’un New rôle n’est pas prise en charge par cette action.
   • User: Select le champ source User ID ou Email, ou indiquez dans le champ Static un sys_id utilisateur, une adresse e-mail ou un nom d’utilisateur séparés par des virgules.
4. Activez le bouton de bascule Exiger une approbation si une approbation est nécessaire avant d’effectuer une action sur les applications.
5. Cliquez sur Save.

Mettre à jour la délégation des utilisateurs

Suivez les étapes suivantes pour configurer l’action Update User Delegation :

1. Dans Risk Exchange, allez à Actions et cliquez sur Add Action Configuration.
2. Select la règle de gestion, la configuration et l'action requises dans leurs listes déroulantes respectives.
3. Fournissez les paramètres des actions suivantes :
   • User: Utilisateur délégué. Select le champ source ID utilisateur ou E-mail, ou indiquez dans le champ statique le sys_id, l’adresse e-mail ou le nom d’utilisateur, séparés par des virgules.
   • Delegate: Utilisateur agissant au nom du délégant. Select un champ source ou indiquez un sys_id, une adresse e-mail ou un nom d’utilisateur, séparés par des virgules, dans le champ Static. Chaque utilisateur est délégué à chaque délégataire.
   • Delegation Settings: Select les paramètres à déléguer dans une liste déroulante statique. La délégation dans ServiceNow est remplacée exactement par cette sélection. Les paramètres sélectionnés sont délégués (true) et les paramètres non sélectionnés ne le sont pas (false). Notez que si aucun paramètre n’est sélectionné, la délégation est supprimée. Si la suppression n’a pas lieu et que l’action est déclenchée, la délégation est créée avec cette valeur, même si l’option Non est sélectionnée pour la durée de la mise à jour de la délégation.
   • Update Delegation Duration: S’applique uniquement lorsqu’une délégation existe déjà pour l’utilisateur et le délégué (par exemple, lorsque ses paramètres sont remplacés, et non lorsqu’ils sont créés ou supprimés). Select Yes pour déplacer également l’heure de fin de la délégation à l’heure actuelle. Pour la durée de la délégation, l’heure de début reste inchangée. Select No (par défaut) pour laisser inchangées les heures de début et de fin de la délégation existante.
4. Activez le bouton de bascule Exiger une approbation si une approbation est nécessaire avant d’effectuer une action sur les applications.
5. Cliquez sur Save.

Manage Device Tags

Suivez ces étapes pour configurer l’action « Gérer les balises de périphériques » :

1. Dans Risk Exchange, allez à Actions et cliquez sur Add Action Configuration.
2. Select la règle de gestion, la configuration et l'action requises dans leurs listes déroulantes respectives.
3. Fournissez les paramètres des actions suivantes :
   • Action Type: S’il faut ajouter (tag) ou supprimer (untag). Select une option dans la liste déroulante du champ Static.
   • Device ID: Select le champ source ID de périphérique de ServiceNow ou indiquez des ID de périphérique (sys_id) séparés par des virgules dans le champ Statique.
   • Tag Key: Clé de tag unique à ajouter ou à supprimer, commune à chaque valeur de tag. Saisissez uniquement la valeur dans le champ statique, avec un maximum de 254 caractères.
   • Tag Value: Valeur(s) de tag pour la clé de tag. Fournissez une valeur unique ou des valeurs séparées par des virgules dans le champ Static, ou sélectionnez un champ source (un champ de type List permet de résoudre plusieurs valeurs). Chaque valeur devient son propre tag partageant la même clé. Lors de la suppression, seuls les tags dont la paire clé/valeur existe sont supprimés.
4. Activez le bouton de bascule Exiger une approbation si une approbation est nécessaire avant d’effectuer une action sur les applications.
5. Cliquez sur Save.

Gérer les tags d’application

Suivez ces étapes pour configurer l’action Gérer les tags d’application :

1. Dans Risk Exchange, allez à Actions et cliquez sur Add Action Configuration.
2. Select la règle de gestion, la configuration et l'action requises dans leurs listes déroulantes respectives.
3. Fournissez les paramètres des actions suivantes :
   • Action Type: S’il faut ajouter (tag) ou supprimer (untag). Select une option dans la liste déroulante du champ Static.
   • Application ID: Select le champ source Application ID ou saisissez un ou plusieurs Application ID (sys_id) séparés par des virgules dans le champ Static.
   • Tag Key: Clé de tag unique à ajouter ou à supprimer, commune à chaque valeur de tag. Saisissez uniquement la valeur dans le champ statique, avec un maximum de 254 caractères.
   • Tag Value: Valeur(s) de tag pour la clé de tag. Fournissez une valeur unique ou des valeurs séparées par des virgules dans le champ Static, ou sélectionnez un champ source (un champ de type List permet de résoudre plusieurs valeurs). Chaque valeur devient son propre tag partageant la même clé. Lors de la suppression, seuls les tags dont la paire clé/valeur existe sont supprimés.
4. Activez le bouton de bascule Exiger une approbation si une approbation est nécessaire avant d’effectuer une action sur les applications.
5. Cliquez sur Save.

Partager les données d'application

Cette action sert à partager avec l’instance ServiceNow les données des applications récupérées depuis Netskope ou d’autres plug-ins tiers.

Suivez les étapes suivantes pour configurer l’action de partage des données de l’application :

1. Dans Risk Exchange, allez à Actions et cliquez sur Add Action Configuration.
2. Select la règle de gestion, la configuration et l'action requises dans leurs listes déroulantes respectives.
3. Fournissez les paramètres des actions suivantes :
   • Select Table: Select la table ServiceNow vers laquelle partager les données de l’application. Entreprise principale fait correspondre les enregistrements d’entreprise / d’entreprise parente. Application métier CI de la CMDB fait correspondre ou crée un enregistrement d’application métier en fonction du nom de l’application.
   • Company Name: Select le champ Nom de l’entreprise dans Source ou indiquez le nom de l’entreprise dans le champ Statique. Utilisé uniquement lorsque Select Table est défini sur Core Company, pour récupérer les informations sur le fournisseur depuis la plateforme ServiceNow.
   • Parent Company Name: Select field for Parent Company Name dans Source ou indiquez Parent Company Name dans le champ Static. À utiliser uniquement lorsque Select Table est défini sur Core Company, afin de récupérer les informations sur le fournisseur depuis la plateforme ServiceNow.
   • Operator: Select l’opérateur dans la liste déroulante du champ statique pour effectuer une opération entre le nom de l’entreprise et le nom de l’entreprise parente. Utilisé uniquement lorsque la table Select est Entreprise principale, et obligatoire lorsque le nom de l’entreprise et celui de la société mère sont tous deux renseignés, comme name=ABC^ORparent.name=XYZ.
4. Activez le bouton de bascule Exiger une approbation si une approbation est nécessaire avant d’effectuer une action sur les applications.
5. Cliquez sur Save.

No Action

Suivez les étapes suivantes pour configurer l’action « Aucune action » :

1. Dans Risk Exchange, accédez à Actions et cliquez sur Add Action Configuration.
2. Select la règle de gestion, la configuration et l'action requises dans leurs listes déroulantes respectives.
3. Activez le bouton de bascule Exiger une approbation si une approbation est nécessaire avant d’effectuer une action sur les applications.
4. Cliquez sur Save.

Valider le plugin ServiceNow

Validation sur Cloud Exchange

Récupérer la validation

To verify the logs related to pulled records, go to the Settings > Logging and apply the filter with plugin name or plugin configuration name.

Pour valider les enregistrements récupérés, accédez à Risk Exchange > Records. Select l’entité sélectionnée lors de la configuration du mappage des champs pour afficher les enregistrements récupérés.

Validation de l'action

Lorsqu’un enregistrement extrait correspond à l’une des règles de gestion configurées, l’action configurée est exécutée sur l’enregistrement. Cela peut être consulté à l’adresse Risk Exchange > Action Logs.

Journaux associés à l'action prise en charge pour le plugin ServiceNow :

Ajouter/supprimer un utilisateur d’un groupe

Mettre à jour la délégation des utilisateurs 

Manage Device Tags 

Ajouter/supprimer un utilisateur d’un rôle 

Gérer les tags d’application

Partager les données d'application

Valider sur ServiceNow

Récupérer la validation

Ce plugin récupère les utilisateurs de la table sys_user (Sécurité système > Utilisateurs et groupes > Utilisateurs), les périphériques de la table cmdb_ci_computer (Configuration > Élément de base > Ordinateurs) et les applications de la table cmdb_ci_business_app (Organisation > Applications métier).

Pour vérifier l’utilisateur disponible, connectez-vous à votre instance ServiceNow et recherchez « Users and Group ».

Cliquez sur Users pour afficher la liste des utilisateurs disponibles.

Cliquez sur l'un des utilisateurs pour afficher ses détails.

Pour vérifier les périphériques disponibles, connectez-vous à votre instance ServiceNow et recherchez « Computers ».

Click Computers under Configuration to view available Devices.

Cliquez sur l’un des périphériques pour ouvrir ses détails.

Pour vérifier les applications disponibles, connectez-vous à votre instance ServiceNow et recherchez Business Applications.

Cliquez sur Business Applications sous Organization pour afficher toutes les applications disponibles sur ServiceNow.

Cliquez sur n’importe quelle application pour ouvrir ses détails.

Validation de l'action

Validation des actions effectuées sur la plateforme ServiceNow :

Ajouter/supprimer un utilisateur d’un groupe

Connectez-vous à votre instance ServiceNow et recherchez Users and Group.

Cliquez sur Users pour afficher la liste des utilisateurs disponibles.

Cliquez sur l’un des utilisateurs pour ouvrir ses détails et accédez à l’onglet des groupes.

Mettre à jour la délégation des utilisateurs 

Paramètres de délégation avant l’exécution de l’action de mise à jour de la délégation de l’utilisateur :

Paramètres de délégation après l’exécution de l’action de délégation de mise à jour de l’utilisateur :

Manage Device Tags

Connectez-vous à votre instance ServiceNow et recherchez « Ordinateurs ».

Click Computers under Configuration to view available Devices.

Recherchez le périphérique sur lequel l'action a été effectuée, puis cliquez dessus pour ouvrir ses détails.

Cliquez sur Open in CMDB Workspace et allez à Tags.

Ajouter/supprimer un utilisateur d’un rôle  

Connectez-vous à votre instance ServiceNow et recherchez Users and Group.

Cliquez sur Users pour afficher la liste des utilisateurs disponibles.

Cliquez sur l’un des utilisateurs pour ouvrir ses détails et accéder à Roles.

Gérer les tags d’application 

Connectez-vous à votre instance ServiceNow et recherchez les applications métier.

Cliquez sur Business Applications sous Organization pour afficher toutes les applications disponibles sur ServiceNow.

Cliquez sur n’importe quelle application pour ouvrir ses détails.

Cliquez sur Open in CMDB Workspace et allez à Tags.

Partager les données d'application 

For Business Applications

Connectez-vous à votre instance ServiceNow et recherchez les applications métier.

Cliquez sur Business Applications sous Organization pour afficher toutes les applications disponibles sur ServiceNow.

Cliquez sur les applications partagées pour afficher leurs détails.

For Core Company

Accédez à User Administration > Companies. Select l’entreprise partagée depuis Cloud Exchange en recherchant son nom, puis consultez les notes ajoutées pour l’entreprise afin de vérifier les données des applications partagées.

Dépannage du plugin ServiceNow

Impossible de configurer le plugin CRE ServiceNow

Si l’utilisateur ne parvient pas à configurer le plugin CRE ServiceNow, cela peut être dû à l’une des raisons suivantes :

• Les informations d'identification fournies sont incorrectes.
• L'utilisateur ne dispose pas des autorisations nécessaires.
• L'URL de l'instance fournie est incorrecte.

What to Do:

1. Veillez à fournir les informations d’identification correctes. Suivez ces étapes dans la section de configuration de ServiceNow.
2. Assurez-vous que l’utilisateur dispose des autorisations requises. Suivez ces étapes dans la section de configuration de ServiceNow.
3. Assurez-vous que l'URL de l'instance est correcte.

Les applications partagées via le plugin ServiceNow sont rapatriées dans Cloud Exchange. 

Cela peut être dû à l’absence de source de découverte ou au fait que celle-ci n’est pas correctement configurée.

Pour résoudre le problème mentionné ci-dessus, configurez correctement la source de découverte. Consultez la section Créer une source de découverte.

Impossible de partager l'application sur la plateforme ServiceNow

Si les applications ne sont pas partagées avec le plugin CRE ServiceNow, cela peut être dû à l'une des raisons suivantes :

• La condition fournie lors de la configuration de l'action ne correspond pas.
• L'utilisateur ne dispose pas des autorisations nécessaires.

What to Do:

1. Veillez à fournir la condition correcte qui correspond à la plateforme ServiceNow. 
2. Assurez-vous que l’utilisateur dispose des autorisations requises. Suivez ces étapes pour attribuer un rôle à l’utilisateur.

403 « Operation Failed » malgré une configuration correcte des ACL

Toutes les ACL sont correctement configurées conformément à la matrice des autorisations, mais les écritures dans une table renvoient toujours le code HTTP 403 avec un message détaillé tel que : « Operation Failed » — « Operation against file ‘table_name’ was aborted by Business Rule ‘RuleName^sys_id' »; cela peut être dû au fait que la table possède une règle métier standard de ServiceNow qui contrôle les écritures selon le rôle, au-delà des ACL au niveau de la table. Le reprovisionnement des ACL ne résoudra pas ce problème : le contrôle du rôle de la règle de gestion doit être étendu.

What to Do:

1. Ouvrez la règle de gestion indiquée dans le message d’erreur

2. Examinez la condition de la règle. Cela inclut probablement une vérification du rôle, comme gs.hasRole('admin'), ou une liste d’exceptions similaire.

3. Si le rôle personnalisé x_netskope_integration que vous avez créé ne figure pas dans cette liste d’exclusions, ajoutez-le.