Gå til innholdet

Referanse for Control Center Connect

Control Center Connect kjører leverandørpålogginger for servere som ikke har registrert egne apper. En server bruker enten den hostede Connect-tjenesten til Control Center, en Connect som organisasjonen kjører (Kjør en Connect-server), eller ingen. Valget ligger under Innstillinger → Server → Enkel pålogging → Control Center Connect, i cc_server connect eller i CC_CONNECT_URL. Et arbeidsområde følger det med mindre en administrator velger noe annet for arbeidsområdet under Innstillinger → Arbeidsområde → Integrasjoner (Valg for hvert arbeidsområde).

Hver leverandør er et spor. Under Bruk mine egne apper (eller før noen har valgt) kjører et spor på serverens egen app når en er fullstendig konfigurert, ellers er det utilgjengelig. Med Control Centers eller en egendefinert Connect håndterer Connect alle spor den betjener: serverens egne apper forblir lagret, men brukes ikke til pålogging, serverautomatisering eller statusen serveren rapporterer. Et arbeidsområde som har valgt sitt eget valg, kjører alle spor etter det valget i stedet.

Spor Egen app trenger Via Connect
github App-id, privat nøkkel, client id og client secret Folk logger inn på den delte GitHub App-en
google Client id og client secret Folk kobler til Google Calendar
linear Client id Folk logger inn på Linear
linear_app Client id En administrator i arbeidsområdet kobler til Linears app-aktør
slack Arbeidsområdets egen tilkobling til en Slack-app En administrator i arbeidsområdet kobler Slack til den delte Slack-appen
klipy KLIPY_APP_KEY GIF-søk, med Connect som proxy

En egen app som bare er delvis konfigurert, gjør sporet sitt til en feil, aldri til en stille reserveløsning via Connect. Et arbeidsområde på Bruk mine egne apper går aldri via serverens apper eller noen Connect, for noen leverandør. Å bytte Connect-valget til serveren logger ingen ut av et arbeidsområde som har valgt sitt eget.

Connect ser Connect ser aldri
Serverens installasjons-ID og forespørselssignaturer Kildekode, innhold i repoer, differ eller tekst i pull requests
Leverandørkontoen som logget inn, under påloggingen Saker, transkripsjoner eller noe annet i en arbeidsområdedatabase
Hvilket arbeidsområde en påloggingsinformasjon tilhører, som en ugjennomsiktig ID inne i seglet Serverens egne app-hemmeligheter: de forlater aldri serveren
Repoet et GitHub-token for ett repo utstedes for Oppdateringstokener i ro: de finnes bare inne i segl som serveren oppbevarer
Slack-team som er bundet til serveren Linear-hemmeligheter: serveren veksler inn koden fra Linear selv
GIF-søkeord, når den er proxy for Klipy Passord, paringsnøkler eller nøkler til modellleverandører
Referanser til Slack-hendelser (team, kanal, meldings-ID) og teksten i slash-kommandoer Teksten i Slack-meldinger: Connect forkaster den ved ankomst, og serveren leser meldingen fra Slack selv

Connect beholder pålogginger under arbeid, nonces og hurtigbuffere i høyst 10 minutter, og timebaserte bruksteller i høyst to timer. Et GitHub-token for ett repo utstedt som en person, forblir registrert, forseglet til påloggingen som ba om det, til det utløper (høyst 8 timer), slik at Connect kan dele det ut på nytt og tilbakekalle det ved frakobling. Connects eneste varige oppføringer er Slack-bindinger (hvilken server hvert Slack-team er bundet til) og pensjonerte installasjons-ID-er. Feil inneholder en kode, aldri leverandørens svar. Logger registrerer installasjons-ID-er bare som nøklede hasher, og et GitHub-token bare som hashed_token GitHubs revisjonslogg for organisasjonen viser for det, slik at en organisasjonseier kan koble de to sammen.

Modus Innstilling Oppførsel
Ikke valgt Ny server Ingen spor bruker Connect. Onboarding ber servereieren velge
hosted Bruk appene til Control Center https://connect.usectrl.dev, med en konfigurasjon signert offline. Serverens egne apper brukes ikke
custom Bruk en egen Connect-server En Connect på en HTTPS-URL (http bare på loopback), klarert ved første bruk. Serverens egne apper brukes ikke
off Bruk mine egne apper Ingen spor bruker Connect. Bare egne apper logger inn folk

CC_CONNECT_URL i serverens miljø eller .env låser valget: hosted, off eller en Connect-URL. Innstillinger viser da låsen og kan ikke endre den.

Dette bygget har ingen innebygd nøkkel for den hostede konfigurasjonen, så hostet modus rapporterer hosted_unprovisioned og betjener ingen spor. Egne apper og en egen Connect fungerer.

Den hostede Connect-tjenesten kjører i én enkelt container. Seglnøkkelen og den delte GitHub App-ens private nøkkel er miljøvariabler der, ikke nøkler i et hvelv som bare signerer eller dekrypterer, slik GitHub anbefaler for en Apps private nøkkel. Det er et kjent gap i det nåværende oppsettet.

En server leser Connects konfigurasjon høyst hvert 10. minutt og venter høyst 5 sekunder på hvert kall. Når Connect ikke kan nås, brukes den siste gode konfigurasjonen fortsatt, og Innstillinger markerer den som foreldet.

Innstillinger → Arbeidsområde → Integrasjoner → Control Center Connect overstyrer serverens valg for ett arbeidsområde. Alle medlemmer ser det og hvor hver pålogging kjører; bare en arbeidsområdeadministrator endrer det.

Valg Oppførsel
Samme som denne serveren Standard. Arbeidsområdet kjører på det serverens eier valgte; alternativet oppgir hva det er
Bruk appene til Control Center Control Centers hostede Connect, uansett hva serveren bruker
Bruk mine egne apper Bare arbeidsområdets egne apper: GitHub-appen, Google-klienten, Linear-applikasjonen, Klipy-nøkkelen og Slack-appen. En leverandør uten en er av her; en delvis konfigurert er en oppsettsfeil
Bruk en egen Connect-server En Connect på en HTTPS-adresse som arbeidsområdet oppgir. Adresser på et privat eller lokalt nettverk avvises
  • Ethvert valg annet enn Samme som denne serveren holder hver persons GitHub- og Linear-pålogginger i en plass som tilhører arbeidsområdet, så de aldri blandes med de som gjelder hele serveren
  • Å bytte spør først: alle i arbeidsområdet logger inn på GitHub, Linear og Google Calendar på nytt gjennom de nye appene
  • Arbeidsområdets egen Slack-app-tilkobling fungerer under alle valg; Legg til Control Center i Slack følger valget
  • CC_CONNECT_URL låser også arbeidsområdene ute fra en egen Connect: de kan følge serveren eller bruke egne apper
  • Et arbeidsområdes egen Connect stoles på ved første bruk, bare for det arbeidsområdet: Stol på nye apper der endrer aldri det serveren eller et annet arbeidsområde stoler på
Element Hva det er
Installasjonsnøkkel Et frø på 32 byte i serverens hemmelighetsfil (connect_install_key), atskilt fra paringsnøklene for enheter
Nøkkel per Connect En Ed25519-nøkkel avledet fra frøet og adressen til Connect-en. Hver forespørsel til Connect signeres med den (RFC 9421)
Installasjons-ID 26 tegn avledet fra den offentlige nøkkelen. Vises i Innstillinger og av cc_server connect status

Samme server har en annen installasjons-ID for hver Connect-adresse. ID-en endres bare når nøkkelen byttes.

En pålogging via Connect returnerer et legitimasjonssegl: en kryptert blob som bare den Connect som laget den, kan åpne. Den er bundet til leverandøren, Connect-adressen, installasjons-ID-en, arbeidsområdet, leverandørkontoen, appen og hemmelighetsgenerasjonen.

  • Serveren lagrer seglet og installasjons-ID-en det ble forseglet for. Tilgangstokener blir værende i minnet
  • For å fornye sender serveren seglet tilbake og får et nytt tilgangstoken og et nytt segl
  • Et segl der installasjons-ID-en eller Connect-adressen ikke lenger stemmer, slettes neste gang det leses, og den personen logger inn på nytt. Dette skjer etter et nøkkelbytte, et bytte til en annen Connect eller en datakatalog som er gjenopprettet på en annen server
  • Et segl Connect ikke kan åpne, avvises med access_denied

En installasjon av den delte GitHub App-en kan brukes fra alle servere. Connect fører ingen oversikt over hvilke servere som kan bruke den.

  • Installer GitHub-appen under Innstillinger → Arbeidsområde → Integrasjoner åpner appens installasjonsside på GitHub. Serveren bygger lenken fra appnavnet i Connects konfigurasjon
  • Et token for ett repo krever at appen er installert hos eieren av repoet, og at innlogget person har tilgang til repoet. Det er personens eget token, begrenset til rollen, aldri mer
  • En organisasjon begrenser Control Center på GitHub: ved å fjerne installasjonen, snevre inn repoene eller fjerne personen
  • For kall bare personen kan gjøre, som å liste installasjonene sine, gir Connect serveren personens egne App-brukertoken, ikke et token for ett repo. Å logge inn på en server er å stole på den serveren med det tokenet
  • En organisasjon som håndhever en IP-tillatelsesliste hos GitHub, kan ikke bruke den hostede Connect, hvis adresser ikke er faste. Den registrerer i stedet sin egen GitHub App, på sine servere eller på en Connect den kjører
  • Koble fra tilbakekaller bare den påloggingen: Connect bruker oppdateringstokenet sitt én gang og sletter det som kommer tilbake, sletter brukertokenet sitt og tokenene for ett repo Connect utstedte for den. En kopi av seglet, hvor den enn ligger, slutter å virke. Personens pålogginger på andre servere og arbeidsområder fortsetter å virke. For å fjerne Control Center fra en GitHub-konto helt, tilbakekall den i GitHub under Innstillinger → Applikasjoner → Autoriserte GitHub-apper → Tilbakekall

Tokener utstedt som appens bot (as: app) viser den samme boten på GitHub for hver server som bruker samme Connect: GitHub kan ikke skille disse serverne fra hverandre.

  • Hver server kan la boten lese og kommentere: read, review og comment (kommentarer, etiketter, tildelinger og reaksjoner på issues og pull requests)
  • Å gjennomgå en pull request som boten (bot, som skriver pull requests) er tillatt bare for servere Connect-operatøren oppfører i CONNECT_GITHUB_REVIEW_BOT_INSTALLS. Alle andre servere får svaret needs_requester, og gjennomgangen publiseres med den ansvarlige personens eget token, som GitHub begrenser til den personen: gjennomgangen vises under deres navn. Dette gjelder publisering av AI-gjennomgang, gjennomgangskommentarer og forespørsler om gjennomgåere
  • Å pushe, opprette en branch og åpne en pull request (write) utstedes aldri som den delte boten. De bruker alltid forespørrerens egen pålogging
  • Å godkjenne en pull request automatiseres aldri, med noe token
  • En server eller et arbeidsområde med sin egen GitHub App beholder boten for alt dette, også gjennomganger
  • En server noen logger inn på, har deres App-brukertoken: opptil 8 timer per token, fornyet til de kobler fra. Det kan handle som dem på hvert repo den delte appen er installert på, som de kan nå. Connect kan kutte en server av for godt (en pensjonert eller nektet installasjon), men et token som allerede er utlevert, forblir gyldig til det utløper
  • Å installere den delte GitHub App-en på en organisasjon samtykker for hver Control Center-server et medlem logger inn på, ikke for én server
  • Boten er delt, som over: en organisasjon kan ikke se på GitHub hvilken server som handlet som boten
  • En organisasjon som vil ha sin egen grense, registrerer sin egen GitHub App og kjører sin egen Connect (Kjør en Connect-server), eller konfigurerer appen på sine egne servere
Connect Hvordan serveren stoler på konfigurasjonen
Hostet Verifiserer en Ed25519-signatur mot nøkler som er kompilert inn i bygget. Avviser en epoke lavere enn den høyeste den har sett (rollback)
Egen Fester GitHubs app-id og client id, client id-ene til Google og Linear og Slacks app- og client id-er ved første bruk. En endring setter pålogginger via Connect på pause (pins_changed) til servereieren trykker Stol på nye apper

Serverens Connect-innstillinger er bare for servereieren.

Operasjon Gjør
connect.status Modus, URL, lås, installasjons-ID, helsetilstand, konfigurasjonsepoke og kilden for hvert spor
connect.configure Setter hosted, custom (med url) eller off
connect.test Henter konfigurasjonen på nytt og rapporterer helsetilstanden
connect.confirmPins Godtar de endrede identifikatorene til en egen Connect
connect.rotateKey Lager en ny installasjonsnøkkel og en ny installasjons-ID (force erstatter den selv når en Connect ikke kunne pensjonere den gamle); se Bytt installasjonsnøkkelen

Et arbeidsområdes eget valg har egne operasjoner, og hver nevner arbeidsområdet:

Operasjon Hvem Gjør
workspaceConnect.status Alle medlemmer Valget, hva det løser seg til, helsetilstand og kilden for hver leverandør. Installasjons-ID og ventende pinner bare for administratorer
workspaceConnect.set Arbeidsområdeadministrator Setter inherit, hosted, custom (med url) eller own
workspaceConnect.test Arbeidsområdeadministrator Henter arbeidsområdets Connect-konfigurasjon på nytt og rapporterer helsetilstanden
workspaceConnect.confirmPins Arbeidsområdeadministrator Godtar de endrede identifikatorene til arbeidsområdets egen Connect

Selve påloggingene bruker oauth.lanes, oauth.begin, oauth.status, oauth.complete, oauth.connections og oauth.disconnect. Personen er alltid den innloggede som kaller.

  1. Serveren ber Connect starte sporet og får leverandørens autoriserings-URL, som den kontrollerer før den viser den. GitHub viser alltid sin kontovelger
  2. Personen godkjenner i nettleseren. Leverandøren går tilbake til Connect
  3. Connect viser hva serveren som startet påloggingen vil kunne gjøre som personen, og hvor lenge. Connect kan ikke si hvem som kjører den serveren, så siden ber personen fortsette bare hvis de selv startet påloggingen, og lukke den hvis noen sendte dem lenken. Når nettleseren er på et annet nettverk enn det påloggingen ble startet fra, sier siden det: det er normalt for en hostet server eller en annen enhet, og det er også det phishing ser ut som. Avbryt avslutter påloggingen: leverandørens kode brukes aldri. Hver side svarer én gang: et svar som ikke kom fra siden Connect nettopp viste, avvises
  4. Etter Fortsett viser Connect en kode på 8 tegn og en control-center://oauth-done-lenke. Den som får koden, får tilgangen som nettopp ble godkjent, så den sendes bare dit påloggingen ble startet
  5. Personen skriver inn koden i appen eller følger lenken. Serveren gjør krav på påloggingen med koden og sitt eget bevis for forespørselen

En pålogging utløper etter 10 minutter. Fem feil koder avslutter den. En lenke som denne appen ikke startet, avvises med Påloggingen ble ikke startet her. Connect begrenser hvor mange pålogginger én nettverksadresse kan starte, og hvor ofte GitHub-tokener utstedes per person og server, per person på tvers av servere, per adresse og for hele appen. Nye pålogginger har et eget budsjett, så de aldri holder opp fornyelsene andre trenger. Etter en grense avvises et kall med rate_limited, og serveren prøver igjen senere uten å logge noen ut. En pålogging over personens grense blir angret hos GitHub og avvist.

Bare serverens eier kan bytte nøkkelen, med Bytt nøkkel på Control Center Connect-kortet under Innstillinger → Server → Enkel pålogging. Det finnes ingen kommando for det. Bytting:

  • Logger alle ut av hvert spor som går via Connect. For hver Connect-server den gamle nøkkelen ble brukt med, tilbakekaller serveren GitHub- og Slack-pålogginger den har derfra (en Google-pålogging har ingenting å tilbakekalle og utløper)
  • Pensjonerer den gamle installasjons-ID-en hos hver av disse Connect-serverne, signert med den gamle nøkkelen og bevist med ett påloggingssegl serveren har fra den Connect-en. Fra da av avviser Connect hver forespørsel som gjøres med den gamle nøkkelen, så et segl eller en kopi av den gamle nøkkelen tatt fra denne serveren er ubrukelig, og Slack-arbeidsområdene bundet til den gamle ID-en frigjøres slik at de kan koble til igjen. Tokener som allerede er utlevert, forblir gyldige til de utløper (en time for et bot-token, åtte timer for en persons). En Connect-server denne serveren ikke har noe segl fra, har ingenting å pensjonere og hoppes over
  • Gir deretter serveren en ny installasjonsnøkkel og en ny installasjons-ID
  • Hvis en Connect-server ikke kan nås, eller nekter å pensjonere den gamle ID-en, stopper den før nøklene byttes og viser Connect kunne ikke pensjonere den gamle nøkkelen. Roter likevel bytter nøkler uansett; den gamle installasjons-ID-en forblir da brukbar hos den Connect-en til tokenene utløper, høyst 8 timer for GitHub
  • Lar pålogginger via serverens egne apper være urørt
  • Krever at den nye installasjons-ID-en legges til i tillatelseslisten til en egen Connect
Kode Betydning
hosted_unprovisioned Dette bygget har ingen nøkkel for den hostede konfigurasjonen
signature Den hostede konfigurasjonen besto ikke signaturkontrollen
rollback Connect serverte en eldre konfigurasjon enn serveren allerede hadde sett
unreachable Serveren kan ikke nå Connect
install_blocked Connect tillater ikke denne installasjons-ID-en, eller den ble pensjonert
pins_changed En egen Connect kunngjorde andre appidentifikatorer
protocol Connect svarte i en form denne serveren ikke forstår