Connectivité SSPM à l’application SaaS - Documentation technique Netskope

This article outlines the common connectivity issues that can occur between SSPM and your integrated SaaS apps. It provides a clear list of SSPM error codes along with their corresponding remediation steps, helping you quickly identify the root cause and restore a healthy connection. Use these tables as your primary reference when diagnosing connectivity failures, permission gaps, or API-related errors across your SaaS integrations.

Si la durée écoulée depuis la dernière analyse dépasse le double de l'intervalle d'analyse de sécurité configuré, vérifiez l'état de l'instance et réattribuez-la si elle se trouve dans un état d'erreur.

How to use the article?

This section contains two tables: SSPM Error Codes and Remediation Steps. Use them sequentially to find your fix.

Identify the Fix: In the SSPM Error Codes table, find your error and note the corresponding Remediation Code.
Apply the Fix: Refer to the Remediation Steps table, using the Remediation Code to locate and follow the instructions.

SSPM Error Codes and Remediation Steps

General

Code d'erreur	Error Log	Détails de l’erreur	Code de remédiation
ErGEN01	Erreur de service	Erreur de service inconnue	RmGEN01
ErGEN02	Unknown API Error	Unknown API error encountered	RmGEN01
ErGEN05	This instance status is not active : ‘error’	Instance is in error state	RmGEN02

Remediation Code	Remediation Steps Summary
RmGEN01	Contacter l'assistance Netskope
RmGEN02	L'instance est dans un état d'erreur. Si le temps écoulé depuis la dernière analyse dépasse le double de l'intervalle programmé pour l'instance, accordez à nouveau l'accès à l'instance pour générer un jeton New.

GitHub

Code d'erreur	Error Log	Détails de l’erreur	Code de remédiation
ErGH01	Cette installation appartenant à l'org a suspendu votre accès	L'installation de l'application GitHub de Netskope est suspendue, ce qui entraîne une erreur lors de la récupération des ressources.	RmGH01
ErGH02	This installation has been suspended	This error occurs when the Netskope GitHub App installation is suspended, preventing the token from being refreshed.	RmGH01
ErGH03	URL introuvable : https://api.github.com/orgs/<org>/audit-log	Le compte GitHub intégré n'est pas un compte d'entreprise, ce qui empêche l'accès à l'API du journal d'audit. Cette inaccessibilité peut entraîner l'absence de mise à jour des suppressions pour certaines ressources.	RmGH02
ErGH04	{“message”:”Not Found”,”documentation_url”:”https://docs.github.com/rest/reference/apps#create-an-installation-access-token-for-an-app”,”status”:”404″}	L'installation de l'application Github a été supprimée ou réinstallée sans que cela ne soit justifié.	RmGH04
ErGH05	l'organisation a une liste d'autorisation IP activée	IP allow list is enabled in the organization	RmGH05
ErGH08	We couldn’t respond to your request in time.	The API timed out, resulting in 504 errors.	RmGH06

Code de remédiation	Résumé des étapes de la remédiation
RmGH01	– Se connecter à l’organisation GitHub intégrée via un compte admin. – Va sur Settings > GitHub Applications. – Ouvrez l’application GitHub installée nommée Introspection pour GitHub. – Va dans Configurer et unsuspend l’application.
RmGH02	Ensure the GitHub account meets the prerequisites outlined in the Onboard GitHub Documentation.
RmGH04	Install Netskope App as mentioned in Onboard GitHub and regrant the instance.
RmGH05	L'organisation a activé la liste blanche des adresses IP. Suivez les étapes mentionnées dans la documentation GitHub d'Onboard pour mettre les IP de Netskope sur liste blanche.
RmGH06	Les délais d'attente occasionnels de l'API Graph constituent une limitation connue, souvent due à un temps de traitement prolongé. Si cette erreur de délai d'attente persiste, augmentez l'intervalle d'analyse de l'instance à plus de 30 minutes. Contactez le support si le problème persiste même après ce réglage.

Salesforce

Code d'erreur	Error Log	Détails de l’erreur	Code de remédiation
ErSF01	expired access/refresh token	Le jeton de rafraîchissement a expiré ou a été révoqué. New Le jeton d'accès ne peut pas être généré à l'aide du jeton de rafraîchissement.	RmSF01
ErSF02	la validité du jeton a expiré	Le jeton de rafraîchissement a expiré ou a été révoqué. New Le jeton d'accès ne peut pas être généré à l'aide du jeton de rafraîchissement.	RmSF01
ErSF03	L'API Métadonnées requiert l'autorisation ModifyMetadata	Modify Metadata Through Metadata API Functions Permission is missing.	RmSF02
ErSF04	L'API EST ACTUELLEMENT DÉSACTIVÉE	API Enabled Permission is missing.	RmSF03
ErSF05	Bad_OAuth_Token	Not authorized to access Salesforce APIs and restricted to retrieve the data.	RmSF04
ErSF06	INVALID_TYPE: Cannot use: OmniInteractionConfig in this organization	OmniInteractionConfig n'est disponible que si l'organisation possède la licence de la plate-forme Omnistudio.	RmSF05
ErSF07	Le type sObject * n'est pas pris en charge	The API is unable to query the sObject Type due to a lack of necessary permissions.	RmSF06
ErSF08	INSUFFICIENT_ACCESS	Les autorisations requises sont manquantes.	RmSF06
ErSF09	No_Access	Les autorisations requises sont manquantes.	RmSF06
ErSF10	sObject type is not supported. INVALID_TYPE	Les autorisations requises sont manquantes.	RmSF06
ErSF11	REQUEST_LIMIT_EXCEEDED	Limite de taux atteinte en raison d'un compte salesforce non-entreprise.	RmSF07
ErSF12	INVALID_SESSION_ID : Cette session n'est pas valide pour l'utilisation de l'API.	Le jeton de rafraîchissement actuel n'est plus valide.	RmSF01
ErSF15	INVALID_TYPE : Impossible à utiliser : Réseau dans cette organisation	Network resource is available only if the org has enabled Digital Experiences.	RmSF08
ErSF16	INVALID_TYPE : Impossible d'utiliser : CustomSite dans cette organisation	CustomSite resource is available only if the org has registered the Salesforce Site Domain.	RmSF09
ErSF17	erreur de connexion en amont ou déconnexion/réinitialisation avant les en-têtes	Le jeton de rafraîchissement actuel n'est plus valide.	RmSF10
ErSF18	We are down for maintenance	Le jeton de rafraîchissement actuel n'est plus valide.	RmSF10
ErSF19	Bad_Id	Le jeton de rafraîchissement actuel n'est plus valide.	RmSF10

Code de remédiation	Résumé des étapes de la remédiation
RmSF01	- Accordez à nouveau l'accès à l'instance Salesforce intégrée. - Configurez l'instance Salesforce pour qu'elle fixe un délai d'expiration du jeton de rafraîchissement plus long, comme indiqué dans la documentation Onboard Salesforce, afin d'éviter d'avoir à réattribuer fréquemment l'accès.
RmSF02	– Ensure the user account used for granting the SSPM instance has the Modify Metadata Through Metadata API Functions permission. – Refer Permissions Required for Salesforce to confirm that the permissions listed are correctly applied.
RmSF03	- Assurez-vous que l'utilisateur qui accorde l'instance du SSPM a la permission "API Enabled". - Reportez-vous aux autorisations requises pour Salesforce afin de confirmer que les autorisations répertoriées sont correctement appliquées.
RmSF04	Ensure uninterrupted and consistent scans by disabling the Lock sessions setting.
RmSF05	– S’assurer que l’organisation possède la licence de la plateforme OmniStudio ainsi que les licences d’extension et d’utilisateur associées. – Assurez-vous que l'API de métadonnées Omnistudio est activée.
RmSF06	Assurez-vous que toutes les autorisations requises pour Salesforce sont correctement appliquées.
RmSF07	L'intégration d'un compte salesforce de l'édition entreprise permet d'éviter l'erreur de limite de taux.
RmSF08	Assurez-vous que l’autorisation « Créer et configurer des expériences » soit accordée et que les expériences numériques soient activées
RmSF09	Assurez-vous que Salesforce Sites est enregistré.
RmSF10	Accordez à nouveau l'accès à l'instance Salesforce intégrée.

Google Workspace

Code d'erreur	Error Log	Détails de l’erreur	Code de remédiation
ErGW01	Non autorisé à accéder à cette ressource/api	The Google Workspace user account utilized to grant instance access is missing the necessary Super Admin role.	RmGW01
ErGW02	Vous n'êtes pas autorisé à lire les registres d'activité	The Google Workspace user account utilized to grant instance access is missing the necessary Super Admin role.	RmGW01
ErGW03	Request had insufficient authentication scopes	Le compte de service Netskope ne dispose pas des champs d'application OAuth nécessaires.	RmGW02

Code de remédiation	Résumé des étapes de la remédiation
RmGW01	J’embarque une instance Google Workspace avec un compte super admin.
RmGW02	Suivez la procédure Grant Scopes to the Netskope Service Account pour fournir les scopes nécessaires au cas où ils auraient été révoqués.

ServiceNow

Code d'erreur	Error Log	Détails de l’erreur	Code de remédiation
ErSN01	L'utilisateur n'est pas autorisé à accéder à la table	ServiceNow user used for granting instance permissions lacks the admin role.	RmSN01
ErSN02	Failed API level ACL Validation	L'étendue de l'accès à l'application nécessaire n'a pas été correctement configurée pour les tables ServiceNow requises.	RmSN02
ErSN03	acces_denied	Le jeton de rafraîchissement a expiré ou a été révoqué. New Le jeton d'accès ne peut pas être généré à l'aide du jeton de rafraîchissement.	RmSN03
ErSN04	Accès restreint	Les restrictions IP sont activées dans l'instance.	RmSN04
ErSN05	Transaction annulée : temps d'exécution maximal dépassé	API response limit is reached.	RmSN05

Code de remédiation	Résumé des étapes de la remédiation
RmSN01	- Assurez-vous que l'utilisateur a un rôle d'administrateur. - Reportez-vous à la section Accès requis pour ServiceNow pour confirmer que les autorisations énumérées sont correctement appliquées.
RmSN02	Follow Enable ServiceNow Table Permissions procedure.
RmSN03	Pour mettre à jour la durée de vie du jeton d'actualisation de l'application Netskope dans ServiceNow : – Connectez-vous à votre compte ServiceNow avec des privilèges d'administrateur. – Dans le panneau de navigation de gauche, recherchez « Système OAuth » et sélectionnez Application Registry. – Cliquez sur l’application créée pour Netskope. – Augmenter le Refresh Token Lifespan. La valeur recommandée est de 31 536 000 secondes (1 an). – Consultez la section « Configurer l’accès à l’API ServiceNow » pour obtenir des instructions détaillées.
RmSN04	- Ajoutez l'adresse IP de Netskope pour autoriser les appels API du service SSPM. - Reportez-vous à la section Onboarding ServiceNow pour configurer les contrôles d'accès aux adresses IP dans votre instance ServiceNow.
RmSN05	Ajustez la « Durée maximale (secondes) » à 120 en System Definition > Transaction Quota Rules > REST Table API request timeout et réaccordez l’instance.

Microsoft 365

Code d'erreur	Error Log	Détails de l’erreur	Code de remédiation
ErM36501	Token permissions do not match required set of permissions	Token Permissions do not match required set permissions for Graph API call.	RmM36501
ErM36502	Intune permissions are not part of the graph access token	Netskope Security Posture Management (SPM) is unable to list Intune resources because the graph access token is missing the necessary permissions.	RmM36501
ErM36504	Request not applicable to target tenant	La licence Intune n'est pas présente pour le compte Microsoft.	RmM36502
ErM36505	Your tenant is not licensed for this feature	La licence Intune n'est pas présente pour le compte Microsoft.	RmM36502
ErM36506	Authorization_IdentityNotFound	Token is not valid.	RmM36501
ErM36507	Authentication_MSGraphPermissionMissing	Required Permission is missing.	RmM36501
ErM36508	Authentication_RequestFromNonPremiumTenantOrB2CTenant	Neither tenant is B2C or tenant does not have premium license.	RmM36503
ErM36509	L'UGS Intune ne fait pas partie du plan de service à la clientèle	La licence Intune n'est pas présente pour le compte Microsoft.	RmM36502
ErM36510	https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations, .+ {“error”:{“code”:”UnknownError”,”message”:”{\”ErrorCode\”:\”Forbidden	La licence Intune n'est pas présente ou les autorisations Intune requises ne sont pas accordées.	RmM36502
ErM36511	"code" : "AuthenticationError", "message" : "AADSTS500014	Netskope service principal is not present in the Microsoft account	RmM36501

Code de remédiation	Résumé des étapes de la remédiation
RmM36501	Accordez à nouveau l'accès à l'instance Microsoft 365 embarquée.
RmM36502	Activez INTUNE_A licence dans le compte Microsoft pour lister les ressources Intune. Si l’erreur persiste après l’activation de la licence, réaccordez l’accès à l’instance Microsoft 365.
RmM36503	L'accès aux rapports de connexion des utilisateurs nécessite une licence Microsoft Entra ID P1 ou P2. Assurez-vous que le locataire dispose d'une licence Microsoft Entra ID P1.

Workday

Code d'erreur	Error Log	Détails de l’erreur	Code de remédiation
ErWD01	La tâche soumise n'est pas autorisée	The requirements outlined on the instance setup page must be met by both the Domain Security Policy linked to the Security Group and the scope assigned to the API client for integration. If these do not align, an error will occur.	RmWD01
ErWD02	allBusinessProcessTypes est inaccessible		RmWD02
ErWD03	allDomains is inaccessible		RmWD03
ErWD04	allSecurityGroups est inaccessible		RmWD04
ErWD05	allWorkdayAccounts est inaccessible		RmWD05
ErWD06	allIntegrationSystemsAudited est inaccessible		RmWD06
ErWD07	permission denied		RmWD07

Code de remédiation	Résumé des étapes de la remédiation
RmWD01	Suivez la procédure pour ajouter la politique de sécurité du domaine au groupe de sécurité et assurez-vous que toutes les autorisations requises pour Workday sont ajoutées.
RmWD02	- Ajoutez la politique de sécurité du domaine Business Process Administration dans le groupe de sécurité avec l'accès View Only . Reportez-vous à la procédure "Politique de sécurité du domaine" vers "Groupe de sécurité". - Suivez les étapes de l'enregistrement d'un client API pour les intégrations dans Workday afin d'ajouter les champs d'application requis au client API.
RmWD03	– Add Security Activation, Security Configuration, and Drive Administrator Domain Security Policy in Security Group with View Only access. Refer Domain Security Policy to Security Group procedure. – Follow Register an API Client for Integrations in Workday steps to add required scopes to API Client.
RmWD04	- Ajoutez Security Activation et Security Configuration Domain Security Policy dans Security Group avec View Only access. Reportez-vous à la procédure "Politique de sécurité du domaine" vers "Groupe de sécurité". - Suivez les étapes de l'enregistrement d'un client API pour les intégrations dans Workday afin d'ajouter les champs d'application requis au client API.
RmWD05	- Ajoutez la politique de sécurité du domaine Workday Accounts, Security Configuration, Security Administration, Security Activation, Purge Person Data dans le groupe de sécurité avec un accès en vue seulement. Reportez-vous à la procédure "Politique de sécurité du domaine" vers "Groupe de sécurité". - Suivez les étapes de l'enregistrement d'un client API pour les intégrations dans Workday afin d'ajouter les champs d'application requis au client API.
RmWD06	- Ajoutez la politique de sécurité du domaine Integration Reports, Integrations: EIBs dans le groupe de sécurité avec un accès en vue seulement. Reportez-vous à la procédure "Politique de sécurité du domaine" vers "Groupe de sécurité". - Suivez les étapes de l'enregistrement d'un client API pour les intégrations dans Workday afin d'ajouter les champs d'application requis au client API.
RmWD07	– Add Workday Query Language Domain Security Policy in Security Group with View and Modify access. Refer Domain Security Policy to Security Group procedure. – Follow Register an API Client for Integrations in Workday steps to add required scopes to API Client.

Box

Code d'erreur	Error Log	Détails de l’erreur	Code de remédiation
ErBox01	Boîte d'erreur L'accès à l'API est interdit pour url:https://api.box.com	Les autorisations requises sont manquantes.	RmBox01

Code de remédiation	Résumé des étapes de la remédiation
RmBox01	Accordez à nouveau l'accès à l'instance de Box pour appliquer les autorisations mises à jour.

Okta

Code d'erreur	Error Log	Détails de l’erreur	Code de remédiation
ErOkta01	Vous n'avez pas la permission d'effectuer l'action demandée	Les autorisations requises sont manquantes.	RmOkta01
ErOkta02	Invalid token provided	Les autorisations requises sont manquantes.	RmOkta01

Code de remédiation	Résumé des étapes de la remédiation
RmOkta01	– Create an API Token in Okta, as mentioned in Onboard Okta. – Refer Roles Required for Okta to confirm that the permissions listed are correctly applied.

Zoom

Code d'erreur	Error Log	Détails de l’erreur	Code de remédiation
ErZoom01	Invalid refresh token	Le jeton de rafraîchissement a expiré. Besoin d'une nouvelle authentification de l'instance.	RmZoom01
ErZoom02	Only available for Paid	L'API Operation Log n'est accessible que pour les comptes Zoom payants.	RmZoom02
ErZoom03	L'accès à l'API REST de Zoom a été refusé à cet utilisateur.	The user account utilized to grant instance access lacks the necessary permissions.	RmZoom03
ErZoom04	Invalid access token, does not contain scopes	Permission is missing.	RmZoom03
ErZoom05	Invalid Token!	Permission is missing.	RmZoom03
ErZoom06	No permission	Permission is missing.	RmZoom03

Code de remédiation	Résumé des étapes de la remédiation
RmZoom01	Accordez à nouveau l'accès à l'instance Zoom embarquée.
RmZoom02	Onboard the Paid Zoom Account.
RmZoom03	Créez l'utilisateur comme indiqué dans la documentation de Onboard Zoom. Utilisez cet utilisateur pour accorder ultérieurement l'accès à l'instance.

Jira

Code d'erreur	Error Log	Détails de l’erreur	Code de remédiation
ErJira01	Non autorisé ; le champ d'application ne correspond pas	Les autorisations requises sont manquantes	RmJira01

Code de remédiation	Étapes de réhabilitation
RmJira01	Accordez l'accès à l'instance Jira pour appliquer les permissions de l'application Netskope.