Contratos de recolección — Jira
01Cómo leer esta página #sec_fa4b2044
Cada recurso que REVIEWIT puede recoger para Jira tiene un contrato publicado. Se lee como una referencia de API: lo que REVIEWIT llama en el servicio recopilado y por qué medio, lo que el contrato exige para que la recolección se ejecute, y los datos que REVIEWIT conserva. REVIEWIT solo realiza lecturas.
- Llamadas: las solicitudes que REVIEWIT dirige al servicio recopilado, todas en lectura.
- Exigencias: cada una debe satisfacerse. Su naturaleza indica lo que solicita: un derecho a conceder al identificador, una condición de administración (una configuración o asignación en el proveedor que el token no incluye, comprobada por una llamada real en lectura), o la pertenencia del identificador al sitio Atlassian de la conexión. La regla indica cuántas opciones se necesitan: « requerida » para la opción única, « una a elección » cuando una sola es suficiente (están ordenadas de la más estrecha a la más amplia: prefiera la primera), « todas », o « N a elección de M ».
- Condiciones de funcionamiento: lo que REVIEWIT comprueba antes de cada recolección, más allá de los requisitos.
- Frescura: la edad máxima de las comprobaciones en las que se basa el veredicto, fijada por cada contrato (aquí: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real). REVIEWIT vuelve a hacer automáticamente dentro de este plazo las comprobaciones que puede realizar (token obtenido, servicio que responde); « Verificar los derechos », en el menú de la conexión, los vuelve a hacer bajo demanda. Mientras no se haga la llamada real, los derechos permanecen no constatados.
- Un derecho cuyo nombre sugiere escritura ( manage:jira-configuration , manage:jira-project , manage:servicedesk-customer ) aparece cuando el proveedor también clasifica la lectura de estos datos; REVIEWIT solo llama a las lecturas enumeradas.
- Datos conservados: los campos que REVIEWIT guarda de cada objeto; el rol indica qué hace la revisión con ellos.
El veredicto de cada recurso, para su conexión, se lee en su ficha. Un recurso que la conexión no recoge siempre puede ser alimentado por la importación de un informe (« Importar un informe »).
02Cómo REVIEWIT verifica los requisitos #sec_48ff108d
El token Jira no incluye sus derechos: el contrato exige que sean constatados por una llamada real, en lectura. REVIEWIT aún no hace esta llamada para Jira: constata que el token está obtenido y que el servicio responde, pero no los derechos enumerados aquí. Los recursos aparecen como « No verificado »; siempre pueden ser alimentados por la importación de un informe (« Importar un informe »).
03Las vías de llamada #sec_f71bc7d9
Una vía indica qué token obtiene REVIEWIT para el identificador: quién lo emite y para qué audiencia. Las direcciones llamadas aparecen en las llamadas de cada recurso; un camino que comienza con « / » se llama en la audiencia del token de su vía.
| Vía | Token emitido por | Audiencia del token | Autenticación del identificador |
|---|---|---|---|
| jira.cloud.reviewit.scoped-token | https://auth.atlassian.com | https://api.atlassian.com | token o secreto de API |
04Assets · Esquemas de objetos #sec_7fede0d1
jira.assets.object-schemas:collect · revisión 2 del contrato, publicado el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Esquemas Assets y los roles que los administran
Llamadas
- GET https://api.atlassian.com/jsm/assets/workspace/{id}/v1/objectschema/list
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerida | read:cmdb-schema:jira |
| Pertenencia | requerida | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| SchemaId | clave del objeto | entero | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| ObjectSchemaKey | contexto, sin efecto sobre la revisión | texto | no |
| Status | contexto, sin efecto sobre la revisión | texto | no |
| ObjectCount | contexto, sin efecto sobre la revisión | entero | no |
| RoleActors | contexto, sin efecto sobre la revisión | texto | no |
05Automatización · Reglas de automatización #sec_97f6845c
jira.automation.rules:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Reglas de automatización, su actor de ejecución y su alcance
Llamadas
- GET https://api.atlassian.com/automation/public/jira/{cloudId}/rest/v1/rule/summary
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerido | manage:jira-configuration |
| Pertenencia | requerido | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| RuleId | clave del objeto | entero | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| State | contexto, sin efecto sobre la revisión | texto | no |
| Scope | contexto, sin efecto sobre la revisión | texto | no |
| ActorAccountId | contexto, sin efecto sobre la revisión | texto | no |
| ActorDisplayName | acceso sujeto a la revisión | lista de identidades | no |
| UpdatedOn | contexto, sin efecto sobre la revisión | fecha y hora | no |
06Directorio · Usuarios #sec_d155e56b
jira.directory.users:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Cuentas Atlassian del sitio, su estado y su acceso a los productos
Llamadas
- 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
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerido | read:jira-user |
| Pertenencia | requerido | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| AccountId | clave del objeto | texto | sí |
| DisplayName | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no | |
| AccountType | contexto, sin efecto sobre la revisión | texto | no |
| Active | contexto, sin efecto sobre la revisión | booleano | no |
| ProductAccess | contexto, sin efecto sobre la revisión | texto | no |
| LastActive | contexto, sin efecto sobre la revisión | fecha y hora | no |
07Grupos #sec_0d3add62
jira.groups.groups:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Grupos del sitio y su uso en los esquemas de permisos
Llamadas
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/group/bulk
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerido | read:jira-user |
| Pertenencia | requerido | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| GroupId | clave del objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| MemberCount | contexto, sin efecto sobre la revisión | entero | no |
08Grupos · Miembros del grupo #sec_06602fe7
jira.groups.memberships:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Pertenencias de grupo. Clave de fila: GroupId | AccountId.
Llamadas
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/group/member
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerido | read:jira-user |
| Pertenencia | requerido | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los derechos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| MembershipKey | clave del objeto | texto | sí |
| GroupId | contexto, sin efecto sobre la revisión | texto | sí |
| GroupName | contexto, sin efecto sobre la revisión | texto | no |
| AccountId | contexto, sin efecto sobre la revisión | texto | sí |
| DisplayName | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no | |
| AccountType | contexto, sin efecto sobre la revisión | texto | no |
09Roles privilegiados · Administradores #sec_bf67dc6b
jira.privileged-roles.admins:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Administradores de organización, sitio y producto
Llamadas
- 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
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerido | read:jira-user |
| Derecho | requerido | manage:jira-configuration |
| Pertenencia | requerido | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los derechos deben constatarse mediante una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| AccountId | clave del objeto | texto | sí |
| DisplayName | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no | |
| AdminScope | contexto, sin efecto sobre la revisión | texto | no |
| Products | contexto, sin efecto sobre la revisión | texto | no |
| Active | contexto, sin efecto sobre la revisión | booleano | no |
10Proyectos · Niveles de seguridad de los tickets #sec_cc7a4005
jira.projects.issue-security:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Niveles de seguridad de los tickets y sus miembros
Llamadas
- 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
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerido | manage:jira-configuration |
| Derecho | requerido | read:jira-work |
| Pertenencia | requerido | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los derechos deben constatarse mediante una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| SchemeId | clave del objeto | entero | sí |
| SchemeName | mostrado para reconocer el objeto | texto | sí |
| LevelId | contexto, sin efecto sobre la revisión | texto | no |
| LevelName | contexto, sin efecto sobre la revisión | texto | no |
| ProjectKeys | contexto, sin efecto sobre la revisión | texto | no |
| HolderType | contexto, sin efecto sobre la revisión | texto | no |
| HolderValue | contexto, sin efecto sobre la revisión | texto | no |
11Proyectos · Esquemas de permisos #sec_686bfaef
jira.projects.permission-schemes:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Esquemas de permisos y los usuarios, grupos y roles que habilitan
Llamadas
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/permissionscheme?expand=all
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerido | manage:jira-configuration |
| Pertenencia | requerido | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los derechos deben constatarse mediante una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| SchemeId | clave del objeto | entero | sí |
| SchemeName | mostrado para reconocer el objeto | texto | sí |
| ProjectKeys | contexto, sin efecto sobre la revisión | texto | no |
| Permission | contexto, sin efecto sobre la revisión | texto | no |
| HolderType | contexto, sin efecto sobre la revisión | texto | no |
| HolderValue | contexto, sin efecto sobre la revisión | texto | no |
12Proyectos #sec_35765212
jira.projects.projects:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Proyectos, su responsable, su tipo y su visibilidad
Llamadas
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/project/search
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Derecho | requerido | read:jira-work |
| Pertenencia | requerido | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los derechos deben constatarse mediante una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| ProjectId | clave del objeto | entero | sí |
| Key | mostrado para reconocer el objeto | texto | sí |
| Name | mostrado para reconocer el objeto | texto | no |
| ProjectTypeKey | contexto, sin efecto sobre la revisión | texto | no |
| Lead | acceso sujeto a la revisión | lista de identidades | no |
| IsPrivate | evaluado por las políticas REVIEWIT (visibilidad) | booleano | no |
| Archived | contexto, sin efecto sobre la revisión | booleano | no |
| Category | contexto, sin efecto sobre la revisión | texto | no |
| Simplified | contexto, sin efecto sobre la revisión | booleano | no |
13Proyectos · Actores de roles de proyecto #sec_ab89471e
jira.projects.role-actors:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Usuarios y grupos colocados en un rol de proyecto. Clave de línea: ProjectKey | RoleId | ActorId.
Llamadas
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/project/{projectId}/role/{roleId}
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerida | read:jira-work |
| Permiso | una al elección | manage:jira-project o manage:jira-configuration |
| Pertenencia | requerida | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| RoleActorKey | clave del objeto | texto | sí |
| ProjectKey | mostrado para reconocer el objeto | texto | sí |
| ProjectName | contexto, sin efecto sobre la revisión | texto | no |
| RoleId | contexto, sin efecto sobre la revisión | entero | sí |
| RoleName | mostrado para reconocer el objeto | texto | no |
| ActorId | contexto, sin efecto sobre la revisión | texto | sí |
| ActorType | contexto, sin efecto sobre la revisión | texto | no |
| ActorName | contexto, sin efecto sobre la revisión | texto | no |
14Gestión de servicios · Clientes #sec_81de5f9e
jira.jsm.customers:collect · revisión 3 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Clientes y participantes externos admitidos en un portal
Llamadas
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/servicedeskapi/servicedesk/{serviceDeskId}/customer
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | una al elección | read:servicedesk-request o manage:servicedesk-customer |
| Pertenencia | requerida | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| AccountId | clave del objeto | texto | sí |
| DisplayName | mostrado para reconocer el objeto | texto | sí |
| mostrado para reconocer el objeto | texto | no | |
| ServiceDeskIds | contexto, sin efecto sobre la revisión | texto | no |
| OrganizationIds | contexto, sin efecto sobre la revisión | texto | no |
| Active | contexto, sin efecto sobre la revisión | booleano | no |
15Gestión de servicios · Organizaciones de clientes #sec_a22c8bb3
jira.jsm.organizations:collect · revisión 3 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Organizaciones clientas vinculadas a un proyecto de servicio
Llamadas
- 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
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | una al elección | read:servicedesk-request o manage:servicedesk-customer |
| Pertenencia | requerida | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| OrganizationId | clave del objeto | entero | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| ServiceDeskIds | contexto, sin efecto sobre la revisión | texto | no |
| CustomerCount | contexto, sin efecto sobre la revisión | entero | no |
| CreatedOn | contexto, sin efecto sobre la revisión | fecha y hora | no |
16Gestión de servicios · Proyectos de servicio #sec_7eade67d
jira.jsm.service-projects:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Proyectos de servicio, sus agentes y su portal
Llamadas
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/servicedeskapi/servicedesk
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerida | read:servicedesk-request |
| Pertenencia | requerida | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser constatados por una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| ServiceDeskId | clave del objeto | entero | sí |
| ProjectKey | mostrado para reconocer el objeto | texto | sí |
| ProjectName | contexto, sin efecto sobre la revisión | texto | no |
| AgentCount | contexto, sin efecto sobre la revisión | entero | no |
| PortalUrl | mostrado para reconocer el objeto | texto | no |
| CustomerPermission | contexto, sin efecto sobre la revisión | texto | no |
17Objetos compartidos · Tableros #sec_22d9391c
jira.shared-objects.dashboards:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Tableros compartidos, su propietario y su audiencia
Llamadas
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/dashboard/search?expand=owner,favouritedCount,sharePermissions,editPermissions
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | read:jira-work |
| Pertenencia | requerido | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser verificados mediante una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| DashboardId | clave del objeto | entero | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| Owner | acceso sujeto a la revisión | lista de identidades | no |
| SharePermissions | contexto, sin efecto sobre la revisión | texto | no |
| EditPermissions | contexto, sin efecto sobre la revisión | texto | no |
| Popularity | contexto, sin efecto sobre la revisión | entero | no |
18Objetos compartidos · Filtros JQL #sec_e790a36e
jira.shared-objects.filters:collect · revisión 2 del contrato, publicada el 18 octubre 2026 · vía jira.cloud.reviewit.scoped-token
Filtros JQL compartidos, su propietario y su audiencia
Llamadas
- GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/filter/search?expand=owner,jql,favourite,favouritedCount,sharePermissions,editPermissions
Requisitos
| Naturaleza | Regla | Opciones |
|---|---|---|
| Permiso | requerido | read:jira-work |
| Pertenencia | requerido | el identificador pertenece al sitio Atlassian de la conexión |
Condiciones de funcionamiento
- se obtiene un token para el identificador
- el servicio https://api.atlassian.com responde
Frescura: comprobaciones de menos de 24 h; los permisos deben ser verificados mediante una llamada real.
Datos conservados
| Campo | Rol | Tipo | Obligatorio |
|---|---|---|---|
| FilterId | clave del objeto | entero | sí |
| Name | mostrado para reconocer el objeto | texto | sí |
| Owner | acceso sujeto a la revisión | lista de identidades | no |
| Jql | contexto, sin efecto sobre la revisión | texto | no |
| SharePermissions | contexto, sin efecto sobre la revisión | texto | no |
| EditPermissions | contexto, sin efecto sobre la revisión | texto | no |
| Favourite | contexto, sin efecto sobre la revisión | booleano | no |
19Para ir más allá #sec_4df27861
- Comprender una conexión de recolección
- Referencia de permisos por recurso
- Leer un veredicto