Contrats de collecte — Jira
01Comment lire cette page #sec_fa4b2044
Chaque ressource que REVIEWIT sait collecter pour Jira a un contrat publié. Il se lit comme une référence d'API : ce que REVIEWIT appelle sur le service collecté et par quelle voie, ce que le contrat exige pour que la collecte s'exécute, et les données que REVIEWIT conserve. REVIEWIT ne fait que des lectures.
- Appels : les requêtes que REVIEWIT adresse au service collecté, toutes en lecture.
- Exigences : chacune doit être satisfaite. Sa nature dit ce qu'elle demande : un droit à accorder à l'identifiant, une condition d'administration (un réglage ou une attribution chez le fournisseur que le jeton ne porte pas, constaté par un appel réel en lecture), ou l'appartenance de l'identifiant au site Atlassian de la connexion. La règle dit combien d'options il faut : « requise » pour l'unique option, « une au choix » quand une seule suffit (elles sont rangées de la plus étroite à la plus large : préférez la première), « toutes », ou « N au choix parmi M ».
- Conditions de fonctionnement : ce que REVIEWIT constate avant chaque collecte, au-delà des exigences.
- Fraîcheur : l'âge maximal des vérifications sur lesquelles le verdict s'appuie, fixé par chaque contrat (ici : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel). REVIEWIT refait automatiquement dans ce délai les vérifications qu'il sait faire (jeton obtenu, service qui répond) ; « Vérifier les droits », dans le menu de la connexion, les refait à la demande. Tant que l'appel réel n'est pas fait, les droits restent non constatés.
- Un droit dont le nom évoque l'écriture ( manage:jira-configuration , manage:jira-project , manage:servicedesk-customer ) figure quand le fournisseur y range aussi la lecture de ces données ; REVIEWIT n'appelle que les lectures listées.
- Données conservées : les champs que REVIEWIT garde de chaque objet ; le rôle dit ce que la revue en fait.
Le verdict de chaque ressource, pour votre connexion, se lit sur sa fiche. Une ressource que la connexion ne collecte pas peut toujours être alimentée par l'import d'un rapport (« Importer un rapport »).
02Comment REVIEWIT vérifie les exigences #sec_48ff108d
Le jeton Jira ne porte pas ses droits : le contrat exige qu'ils soient constatés par un appel réel, en lecture. REVIEWIT ne fait pas encore cet appel pour Jira : il constate que le jeton est obtenu et que le service répond, mais pas les droits listés ici. Les ressources s'affichent « Non vérifié » ; elles peuvent toujours être alimentées par l'import d'un rapport (« Importer un rapport »).
03Les voies d'appel #sec_f71bc7d9
Une voie dit quel jeton REVIEWIT obtient pour l'identifiant : qui le délivre et pour quelle audience. Les adresses appelées figurent dans les appels de chaque ressource ; un chemin qui commence par « / » s'appelle sur l'audience du jeton de sa voie.
| Voie | Jeton délivré par | Audience du jeton | Authentification de l'identifiant |
|---|---|---|---|
| jira.cloud.reviewit.scoped-token | https://auth.atlassian.com | https://api.atlassian.com | jeton ou secret d'API |
04Assets · Object schemas #sec_7fede0d1
jira.assets.object-schemas:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Schémas Assets et les rôles qui les administrent
Appels
- GET https://api.atlassian.com/jsm/assets/workspace/{id}/v1/objectschema/list
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | read:cmdb-schema:jira |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| SchemaId | clé de l'objet | entier | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| ObjectSchemaKey | contexte, sans effet sur la revue | texte | non |
| Status | contexte, sans effet sur la revue | texte | non |
| ObjectCount | contexte, sans effet sur la revue | entier | non |
| RoleActors | contexte, sans effet sur la revue | texte | non |
05Automation · Automation rules #sec_97f6845c
jira.automation.rules:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Règles d'automatisation, leur acteur d'exécution et leur portée
Appels
- GET https://api.atlassian.com/automation/public/jira/{cloudId}/rest/v1/rule/summary
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | manage:jira-configuration |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| RuleId | clé de l'objet | entier | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| State | contexte, sans effet sur la revue | texte | non |
| Scope | contexte, sans effet sur la revue | texte | non |
| ActorAccountId | contexte, sans effet sur la revue | texte | non |
| ActorDisplayName | accès soumis à la revue | liste d'identités | non |
| UpdatedOn | contexte, sans effet sur la revue | date et heure | non |
06Directory · Users #sec_d155e56b
jira.directory.users:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Comptes Atlassian du site, leur statut et leur accès aux produits
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/users/search
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/user?accountId={accountId}&expand=applicationRoles
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | read:jira-user |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| AccountId | clé de l'objet | texte | oui |
| DisplayName | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non | |
| AccountType | contexte, sans effet sur la revue | texte | non |
| Active | contexte, sans effet sur la revue | booléen | non |
| ProductAccess | contexte, sans effet sur la revue | texte | non |
| LastActive | contexte, sans effet sur la revue | date et heure | non |
07Groups #sec_0d3add62
jira.groups.groups:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Groupes du site et leur usage dans les schémas de permission
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/group/bulk
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | read:jira-user |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| GroupId | clé de l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| MemberCount | contexte, sans effet sur la revue | entier | non |
08Groups · Group members #sec_06602fe7
jira.groups.memberships:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Appartenances de groupe. Clé de ligne : GroupId | AccountId.
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/group/member
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | read:jira-user |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| MembershipKey | clé de l'objet | texte | oui |
| GroupId | contexte, sans effet sur la revue | texte | oui |
| GroupName | contexte, sans effet sur la revue | texte | non |
| AccountId | contexte, sans effet sur la revue | texte | oui |
| DisplayName | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non | |
| AccountType | contexte, sans effet sur la revue | texte | non |
09Privileged roles · Administrators #sec_bf67dc6b
jira.privileged-roles.admins:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Administrateurs d'organisation, de site et de produit
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/user/permission/search?permissions=ADMINISTER
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/permissionscheme
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/group/member
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | read:jira-user |
| Droit | requise | manage:jira-configuration |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| AccountId | clé de l'objet | texte | oui |
| DisplayName | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non | |
| AdminScope | contexte, sans effet sur la revue | texte | non |
| Products | contexte, sans effet sur la revue | texte | non |
| Active | contexte, sans effet sur la revue | booléen | non |
10Projects · Issue security levels #sec_cc7a4005
jira.projects.issue-security:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Niveaux de sécurité des tickets et leurs membres
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/issuesecurityschemes
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/issuesecurityschemes/{id}/members
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | manage:jira-configuration |
| Droit | requise | read:jira-work |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| SchemeId | clé de l'objet | entier | oui |
| SchemeName | affiché pour reconnaître l'objet | texte | oui |
| LevelId | contexte, sans effet sur la revue | texte | non |
| LevelName | contexte, sans effet sur la revue | texte | non |
| ProjectKeys | contexte, sans effet sur la revue | texte | non |
| HolderType | contexte, sans effet sur la revue | texte | non |
| HolderValue | contexte, sans effet sur la revue | texte | non |
11Projects · Permission schemes #sec_686bfaef
jira.projects.permission-schemes:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Schémas de permission et les utilisateurs, groupes et rôles qu'ils habilitent
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/permissionscheme?expand=all
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | manage:jira-configuration |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| SchemeId | clé de l'objet | entier | oui |
| SchemeName | affiché pour reconnaître l'objet | texte | oui |
| ProjectKeys | contexte, sans effet sur la revue | texte | non |
| Permission | contexte, sans effet sur la revue | texte | non |
| HolderType | contexte, sans effet sur la revue | texte | non |
| HolderValue | contexte, sans effet sur la revue | texte | non |
12Projects #sec_35765212
jira.projects.projects:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Projets, leur responsable, leur type et leur visibilité
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/project/search
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | read:jira-work |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| ProjectId | clé de l'objet | entier | oui |
| Key | affiché pour reconnaître l'objet | texte | oui |
| Name | affiché pour reconnaître l'objet | texte | non |
| ProjectTypeKey | contexte, sans effet sur la revue | texte | non |
| Lead | accès soumis à la revue | liste d'identités | non |
| IsPrivate | évalué par les politiques REVIEWIT (visibilité) | booléen | non |
| Archived | contexte, sans effet sur la revue | booléen | non |
| Category | contexte, sans effet sur la revue | texte | non |
| Simplified | contexte, sans effet sur la revue | booléen | non |
13Projects · Project role actors #sec_ab89471e
jira.projects.role-actors:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Utilisateurs et groupes placés dans un rôle de projet. Clé de ligne : ProjectKey | RoleId | ActorId.
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/project/{projectId}/role/{roleId}
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | read:jira-work |
| Droit | une au choix | manage:jira-project ou manage:jira-configuration |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| RoleActorKey | clé de l'objet | texte | oui |
| ProjectKey | affiché pour reconnaître l'objet | texte | oui |
| ProjectName | contexte, sans effet sur la revue | texte | non |
| RoleId | contexte, sans effet sur la revue | entier | oui |
| RoleName | affiché pour reconnaître l'objet | texte | non |
| ActorId | contexte, sans effet sur la revue | texte | oui |
| ActorType | contexte, sans effet sur la revue | texte | non |
| ActorName | contexte, sans effet sur la revue | texte | non |
14Service management · Customers #sec_81de5f9e
jira.jsm.customers:collect · révision 3 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Clients et participants externes admis sur un portail
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/servicedeskapi/servicedesk/{serviceDeskId}/customer
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | une au choix | read:servicedesk-request ou manage:servicedesk-customer |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| AccountId | clé de l'objet | texte | oui |
| DisplayName | affiché pour reconnaître l'objet | texte | oui |
| affiché pour reconnaître l'objet | texte | non | |
| ServiceDeskIds | contexte, sans effet sur la revue | texte | non |
| OrganizationIds | contexte, sans effet sur la revue | texte | non |
| Active | contexte, sans effet sur la revue | booléen | non |
15Service management · Customer organisations #sec_a22c8bb3
jira.jsm.organizations:collect · révision 3 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Organisations clientes rattachées à un projet de service
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/servicedeskapi/organization
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/servicedeskapi/organization/{organizationId}/user
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/servicedeskapi/servicedesk/{serviceDeskId}/organization
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | une au choix | read:servicedesk-request ou manage:servicedesk-customer |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| OrganizationId | clé de l'objet | entier | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| ServiceDeskIds | contexte, sans effet sur la revue | texte | non |
| CustomerCount | contexte, sans effet sur la revue | entier | non |
| CreatedOn | contexte, sans effet sur la revue | date et heure | non |
16Service management · Service projects #sec_7eade67d
jira.jsm.service-projects:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Projets de service, leurs agents et leur portail
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/servicedeskapi/servicedesk
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | read:servicedesk-request |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| ServiceDeskId | clé de l'objet | entier | oui |
| ProjectKey | affiché pour reconnaître l'objet | texte | oui |
| ProjectName | contexte, sans effet sur la revue | texte | non |
| AgentCount | contexte, sans effet sur la revue | entier | non |
| PortalUrl | affiché pour reconnaître l'objet | texte | non |
| CustomerPermission | contexte, sans effet sur la revue | texte | non |
17Shared objects · Dashboards #sec_22d9391c
jira.shared-objects.dashboards:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Tableaux de bord partagés, leur propriétaire et leur audience
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/dashboard/search?expand=owner,favouritedCount,sharePermissions,editPermissions
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | read:jira-work |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| DashboardId | clé de l'objet | entier | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| Owner | accès soumis à la revue | liste d'identités | non |
| SharePermissions | contexte, sans effet sur la revue | texte | non |
| EditPermissions | contexte, sans effet sur la revue | texte | non |
| Popularity | contexte, sans effet sur la revue | entier | non |
18Shared objects · JQL filters #sec_e790a36e
jira.shared-objects.filters:collect · révision 2 du contrat, publiée le 18 octobre 2026 · voie jira.cloud.reviewit.scoped-token
Filtres JQL partagés, leur propriétaire et leur audience
Appels
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/filter/search?expand=owner,jql,favourite,favouritedCount,sharePermissions,editPermissions
Exigences
| Nature | Règle | Options |
|---|---|---|
| Droit | requise | read:jira-work |
| Appartenance | requise | l'identifiant appartient au site Atlassian de la connexion |
Conditions de fonctionnement
- un jeton est obtenu pour l'identifiant
- le service https://api.atlassian.com répond
Fraîcheur : vérifications de moins de 24 h ; les droits doivent être constatés par un appel réel.
Données conservées
| Champ | Rôle | Type | Obligatoire |
|---|---|---|---|
| FilterId | clé de l'objet | entier | oui |
| Name | affiché pour reconnaître l'objet | texte | oui |
| Owner | accès soumis à la revue | liste d'identités | non |
| Jql | contexte, sans effet sur la revue | texte | non |
| SharePermissions | contexte, sans effet sur la revue | texte | non |
| EditPermissions | contexte, sans effet sur la revue | texte | non |
| Favourite | contexte, sans effet sur la revue | booléen | non |
19Pour aller plus loin #sec_4df27861
- Comprendre une connexion de collecte
- Référence des droits par ressource
- Lire un verdict