# Set up

### Authentication

Avion uses the highly secure OAuth 2 protocol to allow us to authenticate as you with Linear. This allows Avion to see your issues, teams, projects and workspace.

Read about [permissions required](https://help.avion.io/docs/integrations/backlog-tools/services/linear/permissions-required).

*Y*ou might choose to create a specific integration user that can be controlled by a trusted member of your business. This mitigates against the situation where you have to delete a user that Avion is authenticated with if a person leaves your business. [More info](https://help.avion.io/docs/integrations/set-up-an-integration/authentication#create-a-dedicated-avion-user).

{% hint style="info" %}
You might need to allow pop-ups if you browser blocks them, as Avion uses a pop-up window to authenticate with Linear.
{% endhint %}

<figure><img src="https://3578170569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL6HR00hwiJJav4pLph%2Fuploads%2FouWCN5vOsT9X2s4tqZ8m%2FXnapper-2024-04-17-13.51.17.jpg?alt=media&#x26;token=f74288c0-6996-40b8-9a7c-c69208a581da" alt=""><figcaption></figcaption></figure>

### Releases to projects

You can sync Avion [Releases](https://help.avion.io/docs/story-map/releases) to Linear [projects](https://linear.app/docs/projects), which is really powerful way to plan increments of work from Avion.

<figure><img src="https://3578170569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL6HR00hwiJJav4pLph%2Fuploads%2FIM2CBGcEvV5jZzYVbUeb%2FXnapper-2024-04-17-13.53.30.jpg?alt=media&#x26;token=fa2720b2-dbf6-4043-9cc9-bc98f33fe416" alt=""><figcaption></figcaption></figure>

### State mapping

Map your Avion [workflow](https://help.avion.io/docs/story-map/workflow) to your Linear team workflow. [Advice and info](https://help.avion.io/docs/integrations/backlog-tools/set-up-an-integration/map-story-states).

<figure><img src="https://3578170569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL6HR00hwiJJav4pLph%2Fuploads%2FLjMrfShwiaW8qzavzdas%2FXnapper-2024-04-17-14.01.10.jpg?alt=media&#x26;token=dec595c0-a874-44c6-946e-2e258f8900ab" alt=""><figcaption></figcaption></figure>

Just to help you visualise this, here are the two states in either tool:

<figure><img src="https://3578170569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL6HR00hwiJJav4pLph%2Fuploads%2FmDSuHfDbuOaJTnkR4n8B%2FXnapper-2024-04-17-14.08.11.jpg?alt=media&#x26;token=e6076e91-5c01-463c-9701-0995ce8fe555" alt="" width="375"><figcaption><p>Story states in Avion</p></figcaption></figure>

<figure><img src="https://3578170569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL6HR00hwiJJav4pLph%2Fuploads%2Fx4U9A8uqvudSKTyZ0oqa%2FXnapper-2024-04-17-14.07.10.jpg?alt=media&#x26;token=52d8be2b-cc81-40ea-bcf6-aeeeacefd14b" alt="" width="375"><figcaption><p>Issue states (team workflow) in Linear</p></figcaption></figure>

### Import from Linear

Import your existing issues from Linear. [Advice and info](https://help.avion.io/docs/integrations/backlog-tools/sync-data/importing). You can re-import again later, so any issues that may get added in Linear can always be pulled back into Avion.

<figure><img src="https://3578170569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LL6HR00hwiJJav4pLph%2Fuploads%2F0jf2E0SBRKN9zByFs6nN%2FXnapper-2024-04-17-14.07.38.jpg?alt=media&#x26;token=dd89765f-74cc-439c-80cc-f8466f7e902d" alt=""><figcaption></figcaption></figure>
