Ga naar inhoud

Linear-integratie instellen

Linear heeft in Control Center twee identiteiten, en beide zijn aanmeldingen in de browser: die van jou, voor wat jij doet, en de Control Center-app van de werkruimte, voor wat agenten en pipelines doen. Tickets, projecten, links, medewerkers, delegatie en toewijzing werken allemaal tegen de eigen database van Control Center, zonder dat er een externe dienst nodig is — zie Tickets maken en beheren.

  • De server kan mensen bij Linear aanmelden: via Control Center Connect, of met de eigen Linear-applicatie van de server (Je eigen Linear-applicatie registreren). De servereigenaar kiest in Instellingen → Server → Single sign-on
  • Een beheerder van de werkruimte, om Linear als ticketingprovider te kiezen en Linear-automatisering te verbinden
  1. Ga naar Instellingen → Werkruimte → Integraties en zoek de kaart Tickets
  2. Zet Ticketingprovider op Linear

Tickets die je vanaf dan aanmaakt, krijgen het stempel provider: linear. Lokaal houdt tickets in de eigen database van deze server en verbergt de Linear-rijen: er valt niets te authenticeren.

Je eigen Linear-aanmelding staat op Instellingen → Jij → Profiel, op de kaart Tickets:

  1. Klik op Inloggen bij Linear
  2. Keur goed in je browser
  3. Met de eigen applicatie van de server merkt het dialoogvenster dat vanzelf. Via Connect typ je de code van 8 tekens die de browser toont, of laat je de browser Control Center openen via de control-center://-link

Alles wat je vanuit Control Center in Linear doet, draait op deze aanmelding en niets anders. Ben je niet aangemeld, dan vraagt de app je om je aan te melden in plaats van als iemand anders te handelen.

De aanmelding werkt in elke werkruimte op de server, tenzij een werkruimte eigen aanmeldapps heeft: die werkruimte houdt een eigen Linear-aanmelding. De kaart zegt welke van toepassing is.

De rij Linear-automatisering op de kaart Tickets in Instellingen → Werkruimte → Integraties is de Control Center-app van de werkruimte in Linear. Ticketsynchronisatie, pipelines en agenten schrijven ermee, dus geautomatiseerde issues en opmerkingen verschijnen als Control Center in plaats van als een persoon.

  1. Een beheerder van de werkruimte klikt op Linear verbinden voor automatisering
  2. Die keurt de app goed voor de Linear-werkruimte in de browser, zoals hierboven

De rij toont daarna “Verbonden met je Linear-werkruimte”. Alleen beheerders van de werkruimte kunnen hem verbinden of loskoppelen.

In de sandbox van een agent komen geen Linear-inloggegevens: agenten schrijven tickets via de eigen tools van Control Center, die eerst de regel Naar een externe tracker schrijven raadplegen.

Gebruik je eigen applicatie als je Mijn eigen apps gebruiken hebt gekozen. De applicatie van de server geldt alleen onder Mijn eigen apps gebruiken. Met de Connect van Control Center of een eigen Connect verzorgt Connect Linear, en de applicatie van de server en de service-API-sleutel blijven opgeslagen maar ongebruikt. Een werkruimte op eigen apps (hieronder) gebruikt in plaats daarvan de eigen applicatie, ongeacht de modus van de server.

  1. Maak een OAuth-applicatie aan op linear.app/settings/api/applications/new
  2. Voeg beide callback-URL’s toe die Instellingen → Server → Single sign-on → Provider-apps → Linear onder Callback-URL’s toont, letterlijk: <server origin>/oauth/linear/callback en <server origin>/oauth/linear_app/callback
  3. Plak de Client-id in het blok Linear

Er is geen client-secret: de server meldt zich aan met PKCE. De refreshtokens van Linear verlopen na 30 dagen zonder gebruik, dus de server vernieuwt één keer per dag elke Linear-aanmelding die ouder is dan 20 dagen.

Hetzelfde blok neemt een optionele Service-API-sleutel aan. Dat zijn de eigen Linear-inloggegevens van de server voor automatisering in werkruimtes die geen Linear-automatisering hebben verbonden. Bewaar hem in Instellingen of in het .env-bestand van de server als LINEAR_API_KEY: de server weigert te starten wanneer LINEAR_API_KEY in zijn procesomgeving is geëxporteerd.

Een werkruimte kan zich bij Linear aanmelden via een eigen applicatie in plaats van die van de server. Alleen een beheerder of eigenaar van de werkruimte kan dit instellen.

  1. Maak een Linear OAuth-applicatie aan zoals hierboven
  2. Ga naar Instellingen → Werkruimte → Integraties. Kies op de kaart Control Center Connect Mijn eigen apps gebruiken en klik op Toepassen
  3. Onder Tickets verschijnt de kaart Linear-app. Voeg beide callback-URL’s die de kaart onder Callback-URL’s toont toe aan de Linear-applicatie, precies zoals ze er staan
  4. Plak de Client-id en eventueel de Service-API-sleutel voor de automatisering van deze werkruimte

De applicatie van de werkruimte beantwoordt elke Linear-aanmelding en automatiseringsaanvraag in deze werkruimte, ongeacht hoe de server mensen aanmeldt. Er wordt nooit teruggevallen op de applicatie van de server of op Connect: zolang er geen client-id is, staat Linear uit in deze werkruimte en zegt de kaart wat er ontbreekt. De service-API-sleutel wordt alleen hier gebruikt; zonder die sleutel vereist synchronisatie Linear verbinden voor automatisering.

Mijn eigen apps gebruiken dekt alle providers tegelijk: GitHub, Google Agenda en GIF-zoeken draaien ook alleen op de eigen apps van de werkruimte, elk ingesteld naast de provider op dezelfde pagina. Het wisselen van de aanmeldapps van de werkruimte, of het wijzigen van het client-id van de werkruimte, meldt iedereen in deze werkruimte af bij Linear en koppelt de automatisering los. Zij melden zich opnieuw aan via de nieuwe applicatie. De opgeslagen velden blijven staan wanneer de werkruimte terugschakelt naar een andere keuze, maar worden alleen gebruikt onder Mijn eigen apps gebruiken. Geheimen zijn alleen schrijfbaar: de kaart toont alleen of er een is opgeslagen. Andere werkruimten op de server worden niet beïnvloed.

De rij Linear zegt dat aanmelden niet is ingesteld

Sectie getiteld “De rij Linear zegt dat aanmelden niet is ingesteld”

De server heeft geen eigen Linear-applicatie en ook geen Connect. De servereigenaar kiest er een in Instellingen → Server → Single sign-on. Gebruikt de werkruimte eigen apps, dan staat er in de regel in plaats daarvan dat de installatie niet is voltooid: een beheerder van de werkruimte voegt het client-id toe op de kaart Linear-app onder Instellingen → Werkruimte → Integraties.

Ticketsynchronisatie mislukt met een authenticatiefout

Sectie getiteld “Ticketsynchronisatie mislukt met een authenticatiefout”

De werkruimte heeft geen Linear-automatisering verbonden en de server heeft geen service-API-sleutel, dus de synchronisatie heeft geen inloggegevens. Een beheerder van de werkruimte klikt op Linear verbinden voor automatisering.

Bij het verbinden van automatisering staat dat de Linear-werkruimte elders is verbonden

Sectie getiteld “Bij het verbinden van automatisering staat dat de Linear-werkruimte elders is verbonden”

De Control Center-app van die Linear-werkruimte is al verbonden met een andere Control Center-server.