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.
Hva Connect ser og aldri ser
Seksjon med tittelen «Hva Connect ser og aldri ser»| 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.
Valg for hvert arbeidsområde
Seksjon med tittelen «Valg for hvert arbeidsområde»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_URLlå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å
Installasjonsidentitet
Seksjon med tittelen «Installasjonsidentitet»| 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.
Forseglet påloggingsinformasjon
Seksjon med tittelen «Forseglet påloggingsinformasjon»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
GitHub-installasjoner
Seksjon med tittelen «GitHub-installasjoner»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
Den delte boten
Seksjon med tittelen «Den delte boten»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,reviewogcomment(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 iCONNECT_GITHUB_REVIEW_BOT_INSTALLS. Alle andre servere får svaretneeds_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
Det organisasjonseiere og medlemmer bør vite
Seksjon med tittelen «Det organisasjonseiere og medlemmer bør vite»- 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
Tillit til konfigurasjonen
Seksjon med tittelen «Tillit til konfigurasjonen»| 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 |
Operasjoner
Seksjon med tittelen «Operasjoner»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.
Pålogging via Connect
Seksjon med tittelen «Pålogging via Connect»- 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
- Personen godkjenner i nettleseren. Leverandøren går tilbake til Connect
- 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
- 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 - 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.
Bytt installasjonsnøkkelen
Seksjon med tittelen «Bytt installasjonsnøkkelen»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
Statuskoder
Seksjon med tittelen «Statuskoder»| 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 |