# Installation des Plugins für Jira Cloud

Sie können das **aqua4Jira-Plugin** auf zwei Arten installieren:

**Option 1: Vom Atlassian-Marktplatz**

* Zum [Atlassian Marketplace](https://marketplace.atlassian.com/) gehen
* Suche nach **aqua4jira**

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252FcJOXmpSz8s8D7BkJt2Od%252Fimage.png%3Falt%3Dmedia%26token%3Dfcd319d1-4a7d-4074-9093-de5dd4f4ecc9\&width=768\&dpr=4\&quality=100\&sign=6f91f81\&sv=2)

* Click **Get it now** and select the instance for which you want to install plugin if you have many of them.

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252F6rKUrQ5A4amv9Tc7iIdW%252Fimage.png%3Falt%3Dmedia%26token%3Dedf2971c-3035-45ee-831f-a9ca24390a3a\&width=768\&dpr=4\&quality=100\&sign=74d84eed\&sv=2)

* Follow the instructions to complete the installation. It only takes a few minutes!

**Option 2: From your Jira instance**

* Open your Jira Cloud instance
* Open **Settings** in the top menu

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252FnHFvPDeFooFcwmpiwMJB%252Fimage.png%3Falt%3Dmedia%26token%3De7234da7-7c51-4cbb-80af-ddbc0a249d14\&width=768\&dpr=4\&quality=100\&sign=7f785fc4\&sv=2)

* Click **Apps**

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252Fedz89adLie5NkUn5zDaw%252Fimage.png%3Falt%3Dmedia%26token%3D54334ee6-b19e-4c65-ac54-071b90baa5b4\&width=768\&dpr=4\&quality=100\&sign=46f67cba\&sv=2)

* Once you land on the Apps page, click **Explore apps**

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252Fgwb33V8OphDvvI7oW5p9%252Fimage.png%3Falt%3Dmedia%26token%3D408bf4fd-4a84-4f96-8b56-1ead25e71493\&width=768\&dpr=4\&quality=100\&sign=453f1f93\&sv=2)

* Then search for **aqua4jira**

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252FLJJ2wIsCzw5LWJNFTlwD%252Fimage.png%3Falt%3Dmedia%26token%3D86c81b54-820a-428d-9f72-766de1448a9c\&width=768\&dpr=4\&quality=100\&sign=c09bcdce\&sv=2)

* When you are on aqua4jira page, click on the 'Get it now' button.

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252FrgKIZV2r89kJXSLQV6KG%252Fimage.png%3Falt%3Dmedia%26token%3D0738f3e6-895d-4c02-ab5c-4f32e95392fe\&width=768\&dpr=4\&quality=100\&sign=ac3ff5fe\&sv=2)

Then select the site for which you want to install it and click the **Review** button.

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252Fu6XaukwmtyZD0kWHhqyN%252Fimage.png%3Falt%3Dmedia%26token%3D32f1e10b-6510-465a-ba48-4546a6c46664\&width=768\&dpr=4\&quality=100\&sign=fca73ed5\&sv=2)

In a few seconds it will be installed and you need to click **Manage** app on the toast message that appears once plugin is ready.

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252Fzw4uFQ25zp3SqFDwTChs%252Fimage.png%3Falt%3Dmedia%26token%3Dbacc9654-718e-40fd-8516-7df229f8414c\&width=768\&dpr=4\&quality=100\&sign=5f119aca\&sv=2)

You will be navigated to the Apps page where you need to select **aqua Configuration** on the sidebar.

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252FSwRBgaCk0oWhTwAw8io1%252Fimage.png%3Falt%3Dmedia%26token%3D221556b3-c09c-4fa7-bd8f-a5a8da6f0094\&width=768\&dpr=4\&quality=100\&sign=91c1226c\&sv=2)

#### **aqua pre-requisites** <a href="#aqua-pre-requisites" id="aqua-pre-requisites"></a>

To connect the plugin, you need to create a **technical user** in aqua and assign them the **Jira plugin license**.

This license is included with every paid aqua subscription by default, at no extra cost.

Creating a technical user works the same way as adding any other user in aqua. For step-by-step instructions, check out our guide: [*How to add a new user*.](https://docs.aqua-cloud.io/documentation/user-administration/adding-and-editing-user-profile#adding-user)

Once user is created, you need to assign all projects from which you'd like to link test cases and test scerios (suites). Since technical user doesn't modify any items, a role with read-only permissions will suffice.

#### **Configuring plugin in Jira** <a href="#configuring-plugin-in-jira" id="configuring-plugin-in-jira"></a>

At the configuration page, you need to provide:

* the base URL of your aqua site
* username of your technical user
* password of your technical user

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252FXRYmAW1AKLPLnf2mfdbB%252Fimage.png%3Falt%3Dmedia%26token%3Dba68b19e-6130-4965-947b-c322356d6aa0\&width=768\&dpr=4\&quality=100\&sign=e1330e2\&sv=2)

You can click to test connection to verify if everything has been filled out correctly.

![](https://docs.aqua-cloud.io/~gitbook/image?url=https%3A%2F%2F3920520305-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FyZbW8vbNs5hz8x57emJJ%252Fuploads%252FYL8cjXk3n2uLrGVZxq4P%252Fimage.png%3Falt%3Dmedia%26token%3De4b2b849-4d71-4256-ab46-c1bd0e9d4345\&width=768\&dpr=4\&quality=100\&sign=d3d041e3\&sv=2)

Next, choose whether you want to enable test cases, test scenarios, or both.

You can also restrict access to specific Jira projects if needed.

Once you've set your preferences, click **Save** to apply the configuration.

The plugin is ready to be used.

Du kannst das Plug-in direkt aus Jira im Apps-Bereich finden und installieren.

Sie können das **aqua4Jira** Plugin auf zwei Arten installieren

**Option 1: Vom Atlassian Marketplace**

* Öffnen Sie  [Atlassian Marketplace](https://marketplace.atlassian.com/)
* Suchen Sie nach  **aqua4jira**

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FX80C3YxpLJG8HdBwIkOi%2Fimage.png?alt=media&#x26;token=edbec8b5-cb52-4d5d-b09f-1b0c9cea3ac9" alt=""><figcaption></figcaption></figure>

* Klicken Sie auf **Jetzt installieren** und wählen Sie die Instanz aus, für die Sie das Plugin installieren möchten, falls Sie mehrere

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FWlO1EgOQudn6X0Sqp5SG%2Fimage.png?alt=media&#x26;token=24276258-2aeb-4566-9551-44217f63de11" alt=""><figcaption></figcaption></figure>

* Befolgen Sie die Anweisungen, um die Installation abzuschließen. Es dauert nur wenige Minuten!

**Option 2: Von Ihrer Jira-Instanz**

* Öffnen Sie **Ihre** Jira Cloud-Instanz
* Öffnen Sie die **Einstellungen** im oberen Menü

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FWVARFt3HkZeCsltc6AHt%2Fimage.png?alt=media&#x26;token=0e70a229-d8a6-467a-91c5-75d1b9372961" alt=""><figcaption></figcaption></figure>

* Clicen Sie auf  **Apps**

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2F3udyJomxB1PUpSOoMCKJ%2Fimage.png?alt=media&#x26;token=61e862a1-e849-46be-a8cc-e2b64e765116" alt=""><figcaption></figcaption></figure>

* Sobald Sie auf der App-Seite sind, klicken Sie auf **Neue Apps finden**

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2F0cLm2MaFGnZ1StXBFbF7%2Fimage.png?alt=media&#x26;token=6bad1fd5-9a34-4fa9-b5e5-9e98a0df2296" alt=""><figcaption></figcaption></figure>

* Dann suche nach **aqua4jira**

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FvXA6rf9VDJUZMl6zLDzu%2Fimage.png?alt=media&#x26;token=98fad04b-0bd2-4f8f-8b66-03d9c613130b" alt=""><figcaption></figcaption></figure>

* Wenn Sie auf der Aqua4Jira-Seite sind, klicken Sie auf "Get in now"

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FsjAey4yccq4XxHujjlOg%2Fimage.png?alt=media&#x26;token=32e9854e-ce6a-44e7-932b-22c13b0dd4a4" alt=""><figcaption></figcaption></figure>

Wählen Sie dann die Website aus, für die Sie es installieren möchten, und klicken Sie auf die **Rewiev**

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FRIHHSsgBRtM0AS41lR4f%2Fimage.png?alt=media&#x26;token=e64c5c1a-2eb4-4b13-81a5-240ffbae5781" alt=""><figcaption></figcaption></figure>

In wenigen Sekunden ist es installiert und Sie müssen auf der Toast-Meldung, die erscheint, sobald das Plugin bereit ist, auf App verwalten klicken.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FHfMNxmLCO5XYlr7c77KF%2Fimage.png?alt=media&#x26;token=cb07db42-c1f5-40ba-8b30-c0c82bad48c8" alt=""><figcaption></figcaption></figure>

Sie werden zur Seite „Apps“ weitergeleitet, wo Sie in der Seitenleiste die Option **aqua Konfiguration** auswählen müssen.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FLR8SYX1F18o6TmJx1KtS%2Fimage.png?alt=media&#x26;token=6dd1e14b-dc68-43dd-b90d-7e9d7a23e086" alt=""><figcaption></figcaption></figure>

### **aqua pre-requisites**

To connect the plugin, you need to create a **technical user** in aqua and assign them the **Jira plugin license**.

This license is included with every paid aqua subscription by default, at no extra cost.

Creating a technical user works the same way as adding any other user in aqua.\
For step-by-step instructions, check out our guide: [*How to add a new user*.](https://docs.aqua-cloud.io/documentation/de-documentation/~/revisions/jTwnkJ1ie293nfxptIGP/integration/aqua4jira-plugin-jira-ausgabe-mit-aqua-testfallen-abdecken/broken-reference)

Once user is created, you need to assign all projects from which you'd like to link test cases and test scerios (suites). Since technical user doesn't modify any items, a role with read-only permissions will suffice.

### Plugin in Jira konfigurieren

Auf der Konfigurationsseite müssen Sie Folgendes angeben:

* die Basis-URL Ihrer aqua-Site
* Benutzername des technischen Benutzers
* Passwort Ihres technischen Benutzers

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FlEnpEspMVzlsEfVuKmVn%2Fimage.png?alt=media&#x26;token=bc6a2e40-6f5d-4fee-9f32-3c3e7b90ea8f" alt=""><figcaption></figcaption></figure>

Sie können auf „Verbindung testen“ klicken, um zu überprüfen, ob alles korrekt ausgefüllt wurde.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FPO3CeDMqnA4sidnplrKu%2Fimage.png?alt=media&#x26;token=96c17a5a-e5cc-4f2a-8f6c-f3b004aabb2a" alt=""><figcaption></figcaption></figure>

Wählen Sie anschließend, ob Sie Testfälle, Testszenarien oder beides aktivieren möchten.

\
Bei Bedarf können Sie auch den Zugriff auf bestimmte Jira-Projekte beschränken.\
Sobald Sie Ihre Einstellungen festgelegt haben, klicken Sie auf Speichern, um die Konfiguration zu übernehmen.

\
Das Plugin ist jetzt einsatzbereit.