Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

In the settings you can decide how and when issues are created.

There are small differences between the two project types. Service Management has a few settings in addition.

Jira Software Project

Before you can start to register certificates you are tasked to complete and save the settings.

Issue creation settings

Following fields are available:

  • Create issue x days before expiry: this number defines when the issue is created. The default is 4 weeks. It requires a value between 0 and 90.

  • Issue or request: For Software project there is only issue.

  • Issue type: Please select the appropriate issue type from the dropdown, which offers all the available issue types form your project.

  • Issue summary

  • Issue description

As indicated for “Issue summary” and “Issue Description”, the usage of certificate variables is possible and allows the creation of meaningful outputs.

Available are: {{commonName}} {{alternateName}} {{issuer}} {{issuerCN}} {{validFrom}} {{validUntil}} {{notes}}

Jira additional fields mappings and values

This section enables you to add additional fields (simple custom fields) and values that you wish to populate. As a standard for software projects, the setting is pre-populated with the 'Due date'.

For text fields you can use again the variables from above.

For date fields you have the option to populate them dependant from the date certificate variables like validUntil.

Dates can be manipulated with 'minusDays' and 'plusDays' after the date variable.

{{ validUntil | minusDays: 7 }} means one week before ‘validUntil’ from the certificate

image-20240924-165910.png

For testing purposes of your settings you do not need to wait until an certificate expires, you can use the button ‘Create test issue’ at the bottom of the form.

Please do not forget to press 'Save' when done.

Import & Export

The app allows in the import & export tab to download all data and settings as json file.

You can also upload data in the same structure. Please be aware that your data is only overwritten with the import, the certificates based on their uuid. It does not delete any data.

Jira Service Management

Before you can start to register certificates you are tasked to complete and save the settings.

Issue creation settings

Following fields are available:

  • Create issue x days before expiry: this number defines when the issue is created. The default is 4 weeks. It requires a value between 0 and 90.

  • Issue or request: In the context of service management projects, users have the option to select either ‘issue’ or ‘request’. This defines if it creates for the certificate renewal an issue or a service request.

  • Request type: Please select the request type you want to use for certificate renewals.

  • Issue type: Please select the issue type you want to use for certificate renewals.

  • Issue summary

  • Issue description

As indicated for “Issue summary” and “Issue Description”, the usage of certificate variables as well as the name or the organisation is possible to create meaningful outputs.

Available are: {{organisation}} {{commonName}} {{alternateName}} {{issuer}} {{issuerCN}} {{validFrom}} {{validUntil}} {{notes}}

Jira additional fields mappings and values

This section enables you to add additional fields (simple custom fields) and values that you wish to populate. For service management projects following fields are pre-populated:

  • Organisation

  • Affected services

  • Planned start

  • Planned end

Please make sure to select from the dropdown the matching custom field from your project.

Additional fields values

For text fields you can use again the variables from above.

Dates can be manipulated with 'minusDays' and 'plusDays' after the date variable.

{{ validUntil | minusDays: 7 }} means one week before ‘validUntil’ from the certificate

To set the time for e.g. planned start use 'hour' after the date variable.

{{ validUntil | minusDays: 7 | hour: 18}} means one week before ‘validUntil’ at 6pm

image-20240924-165555.png

Jira API

This is required if you want to use ‘affected services’

Unfortunately Jira does not allow apps to use internally the APIs offering ‘affected services’. We found a workaround by using the official public APIs. For this you have to provide a valid API key as instructed on the page.

image-20240924-165804.png

Import & Export

The app allows in the import & export tab to download all data and settings as json file.

You can also upload data in the same structure. Please be aware that your data is only overwritten with the import, the certificates based on their uuid. It does not delete any data.

Please be aware that the export also contains your API secret - please handle careful or remove the section from the json after download.

  • No labels