Jira global permission

On This Page

    The jira:globalPermission module allows you to define custom global permissions for Jira. Global permissions are not related to any particular entity and are useful if you need to manage permissions for operations performed on global objects.

    A custom global permission behaves as any other Jira permission. Administrators may manage it in the UI and your add-on can access it through REST APIs.

    The format of the permission key is: ari:cloud:ecosystem::extension/[App ID]/[Environment ID]/static/[Permission key].

    Note that there is a similar module for project permissions.

    Properties

    PropertyTypeRequiredDescription
    key

    string

    Yes

    A key for the module, which other modules can refer to. Must be unique within the manifest.

    Regex: ^[a-zA-Z0-9_-]+$

    namestring or i18n objectYes

    The name of the permission.

    The i18n object allows for translation and is available to participants of the Internationalization for Forge EAP. See i18n object.

    descriptionstring or i18n objectYes

    Description of the global permission. It will be displayed under the permission's name.

    The i18n object allows for translation and is available to participants of the Internationalization for Forge EAP. See i18n object.

    anonymousAllowedbooleanYesSpecifies if this permission can be granted to anonymous users.
    defaultGrantsstring

    Specifies the group of users that will be granted this permissions when the add-on is first installed. Please note that existing permission configuration won't be overwritten during add-on upgrades or re-installations. Allowed values:

    • all - if anonymousAllowed is set to true, every user, both logged in and anonymous, will be granted the permission. Otherwise, the permission will be granted to every user with an application role assigned.
    • jira-administrators - every user with the Jira administration permission will be granted this permission.
    • none - by default, the permission will not be granted to anyone.

    i18n object

    Internationalization (i18n) for Forge apps is now available through Forge's Early Access Program (EAP). For details on how to sign up for the EAP, see the changelog announcement.

    EAPs are offered to selected users for testing and feedback purposes. APIs and features under EAP are unsupported and subject to change without notice. APIs and features under EAP are not recommended for use in production environments.

    For more details, see Forge EAP, Preview, and GA.

    KeyTypeRequiredDescription
    i18nstringYesA key referencing a translated string in the translation files. For more details, see Translations.

    Example

    1
    2
    modules:
      jira:globalPermission:
        - key: "forge-global-permission"
          name: "Forge global permission"
          description: "Forge custom global permission"
          anonymousAllowed: false
          defaultGrants:
            - "all"
    

    Rate this page: