Je Cloud SQL-instance heeft geen publiek IP-adres.
Bereik hem op naam, zonder bastion-VM.
AgentsRoom start de Cloud SQL Auth Proxy zodra je de verbinding opent en laat zijn databaseclient daarmee verbinden. Je geeft de verbindingsnaam van de instance, project:region:instance, of kiest hem uit de lijst die je gcloud-login kan zien.
De proxy wordt geautoriseerd door je Application Default Credentials (standaardinloggegevens van de applicatie), dus AgentsRoom bewaart geen sleutel van een serviceaccount. Met IAM-databaseauthenticatie is er ook geen databasewachtwoord. En een AI-coderingsagent kan dezelfde instance bevragen, alleen-lezen.
Hoe AgentsRoom een Cloud SQL-instance op zijn privé-IP bereikt via de Cloud SQL Auth Proxy, zonder iets op te slaan aan de kant van de app.
Een Cloud SQL-instance met alleen een privé-IP is de juiste opzet, maar ook een lastige. De database leeft in je VPC, het publieke IP staat uit en alleen machines binnen dat netwerk kunnen erbij. Dan moeten er voor een bug drie rijen worden bekeken, vanaf een laptop.
Google heeft het antwoord al: de Cloud SQL Auth Proxy. Die opent een versleutelde verbinding met de instance, geautoriseerd door je Google-identiteit in plaats van door een IP-allowlist, en stelt hem beschikbaar als lokale poort. De wrijving zit in alles eromheen: hem installeren, de verbindingsnaam van de instance onthouden, hem in een terminal starten voordat je een client opent, en hem daarna vergeten terwijl hij blijft draaien.
AgentsRoom doet dat deel. Je kiest Google Cloud SQL in het veld Bereiken via van een databaseverbinding, geeft de instance op, vinkt Privé-IP of IAM-databaseauthenticatie aan als je die nodig hebt, en vanaf dan is die database openen één klik. De proxy start met de verbinding en stopt ermee.
De gebruikelijke omwegen kosten allemaal iets
Drie antwoorden op hetzelfde probleem, en wat elk daarvan je kost.
Een bastion-VM alleen hiervoor
Een Compute Engine-VM met een SSH-poort, in de VPC gehouden zodat iemand af en toe een tunnel naar de database kan openen. Hij moet worden gepatcht, kost elk uur geld, en zijn SSH-sleutels en firewallregels raken verouderd naarmate het team verandert.
Een publiek IP en een allowlist
Het publieke IP aanzetten en je thuisadres aan de geautoriseerde netwerken toevoegen werkt tot je adres verandert, en intussen luistert de database op het internet. Het is de uitzondering die nooit meer wordt weggehaald.
Een sleutel van een serviceaccount op een laptop
Een JSON-sleutel downloaden om de proxy te draaien is de snelle route waar iedereen spijt van krijgt: een langlopend inloggegeven in een map Downloads, gekopieerd naar scripts en prompts, dat niemand roteert en niemand kan traceren.
Van een private Cloud SQL-instance naar een resultaat
Vier stappen, één keer gedaan, daarna is het één klik.
Log één keer in met gcloud
Voer gcloud auth application-default login uit op je machine. De Application Default Credentials die dat aanmaakt, gebruikt de proxy om de instance te bereiken. AgentsRoom leest er niets van en slaat er niets van op.
Kies de instance in Bereiken via
Maak een MySQL- of PostgreSQL-verbinding en kies Google Cloud SQL in Bereiken via. Typ de verbindingsnaam van de instance, project:region:instance, of klik op Mijn instanties tonen om hem te kiezen uit wat je gcloud-login kan zien. Host en poort verdwijnen: de instance is het adres.
Kies privé-IP en IAM-authenticatie
Vink Privé-IP aan als de instance geen publiek adres heeft en je machine zijn VPC bereikt via een VPN of Interconnect. Vink IAM-databaseauthenticatie aan om in te loggen met je Google-identiteit: het wachtwoordveld verdwijnt en de gebruiker is je IAM-databasegebruiker.
Bevraag hem, of laat een agent hem bevragen
Bij het openen van de verbinding wordt een vrije loopback-poort gereserveerd, wordt cloud-sql-proxy erop gestart en wordt gewacht tot hij een TCP-verbinding accepteert. De console verbindt met 127.0.0.1 zoals bij elke andere verbinding, en een AI-agent kan hem via MCP bevragen, alleen-lezen. Als je de verbinding sluit, stopt de proxy.
Het commando dat AgentsRoom start
Er wordt niets opnieuw geïmplementeerd. AgentsRoom draait het eigen cloud-sql-proxy-binary van Google (versie 2) als kindproces, met de argumenten rechtstreeks doorgegeven en niet via een shell. Als je de proxy ooit met de hand hebt gestart, is dit de regel die je al kent.
cloud-sql-proxy acme-prod:europe-west1:orders \
--address 127.0.0.1 --port 54321 \
--private-ip \
--auto-iam-authnDe instance en de twee opties komen uit de verbinding die je hebt opgeslagen. De lokale poort wordt bij het openen door het besturingssysteem gekozen.
De proxy accepteert de lokale verbinding voordat hij iets controleert, laat hem daarna vallen en logt waarom als er iets mis is. AgentsRoom leest dat log en vertelt je de echte oorzaak: de proxy is niet geïnstalleerd, je gcloud-login is verlopen (met het commando om uit te voeren), je account mist de rol Cloud SQL Client, de instance heeft geen privé-IP, of de instancenaam klopt niet.
Wat er moet kloppen voordat het werkt
AgentsRoom stuurt je Google Cloud-opzet aan, het vervangt haar niet. Dit zijn dezelfde dingen die de proxy zelf nodig heeft.
cloud-sql-proxy op je machine
Versie 2 van de Cloud SQL Auth Proxy, in je PATH. gcloud components install cloud-sql-proxy is de snelste manier; Google levert hem ook als losse download. Ontbreekt hij, dan zegt AgentsRoom dat en noemt het commando.
Application Default Credentials
gcloud auth application-default login, één keer uitgevoerd. Wanneer die login verloopt, zegt de fout dat je hem opnieuw moet uitvoeren in plaats van een gesloten socket te tonen.
De rol Cloud SQL Client
Je Google-account heeft de rol Cloud SQL Client nodig op het project van de instance, en de Cloud SQL Admin API moet daar zijn ingeschakeld. IAM-databaseauthenticatie vraagt ook om de rol Cloud SQL Instance User en een IAM-gebruiker op de instance.
gcloud voor de keuzelijst
Mijn instanties tonen voert gcloud sql instances list uit in je actieve project, of in het project dat je begon te typen. Zonder gcloud kun je de verbindingsnaam nog steeds met de hand typen.
Een route naar de VPC voor privé-IP
Privé-IP betekent dat je machine zelf de VPC van de instance moet kunnen bereiken, via een VPN, Interconnect of een machine binnen het netwerk. Zonder die route laat je Privé-IP uit en gebruik je het publieke IP met de versleuteling van de proxy.
Wat de proxy doet, en wat hij weigert te doen
De eigenschappen die bepalen of dit veilig ingesteld kan blijven staan op een laptop.
Alleen loopback
De proxy luistert op 127.0.0.1 en nergens anders. De database wordt nooit opnieuw gepubliceerd op het lokale netwerk, dus de wifi van een koffiebar wordt geen route naar productie.
Een poort die het OS kiest
AgentsRoom vraagt het besturingssysteem om een vrije poort en geeft die aan de proxy. Geen vaste poort om te onthouden, geen botsing met een andere proxy die je met de hand hebt gestart.
Gereed betekent gereed
De verbinding opent pas zodra de lokale poort TCP accepteert, en een proxy die meteen stopt, meldt de reden die hij heeft geprint. Geen willekeurige wachttijd, geen client die te vroeg verbindt.
Geen sleutel opgeslagen
De proxy wordt geautoriseerd door je Application Default Credentials. AgentsRoom bewaart de verbindingsnaam van de instance en twee opties, geen van beide een inloggegeven, en geen sleutel van een serviceaccount komt ooit in de app.
De database blijft alleen-lezen
Een databaseverbinding is alleen-lezen wanneer ze wordt aangemaakt. Schrijven vraagt om een beschrijfbaar gemaakte verbinding en een expliciete bevestiging, nadrukkelijker bij een verbinding die als productie is gemarkeerd.
Eén statement per aanroep
Elke aanroep bevat precies één statement, dus niets verstopt zich achter een puntkomma, en resultaten zijn begrensd zodat een brede query geen venster of agentcontext kan overspoelen.
Waarom dit minder toegang is, niet meer
Aan de kant van de instance wordt niets geopend. Het publieke IP kan uit blijven, er wordt geen netwerk aan de geautoriseerde lijst toegevoegd en er blijft geen VM met een SSH-poort draaien voor de incidentele query. De proxy versleutelt de verbinding van begin tot eind naar de instance.
De autorisatie blijft waar je organisatie haar beheert: je Google-identiteit en de bijbehorende IAM-rollen. Toegang die aan die identiteit is verleend, wordt gelogd zoals elke andere Cloud SQL-verbinding en eindigt op de dag dat de rol wordt ingetrokken. AgentsRoom bewaart de instancenaam, de keuze voor Privé-IP en de IAM-keuze, en niets wat iemand die ze las kan hergebruiken.
Aan de databasekant gelden dezelfde vangrails als voor elke AgentsRoom-verbinding: standaard alleen-lezen, één statement per aanroep, begrensde resultaten en een productievlag die de schrijfbevestiging aanscherpt. Een AI-agent die via MCP bevraagt, krijgt een resultaat, nooit een inloggegeven, en kan niet schrijven tenzij je die verbinding beschrijfbaar hebt gemaakt en Agenten schrijfrechten geven ervoor hebt ingeschakeld.
MySQL en PostgreSQL, nog geen SQL Server
Cloud SQL draait MySQL, PostgreSQL en SQL Server. AgentsRoom bereikt de eerste twee via de proxy en heeft vandaag geen SQL Server-client. AlloyDB, dat een eigen proxy heeft, wordt evenmin gedekt.
Welke engine of dienst als volgende komt, wordt bepaald door wat mensen vragen. Ontbreekt de jouwe, zeg dan op de openbare backlog om welke het gaat en hij wordt meegeteld.
Vraag je database-engine aanEen agent kan hem ook bevragen, alleen-lezen
Zodra de verbinding bestaat, gebruikt een AI-coderingsagent haar via de MCP van AgentsRoom door haar bij naam te noemen: db_list, db_schema om tabellen en kolommen door te lopen, db_query voor één statement met begrensde rijen. Een agent kan ook zelf een Cloud SQL-verbinding registreren met db_connection_new of db_connection_save, door de verbindingsnaam van de instance op te geven.
AgentsRoom start de proxy zelf wanneer de agent erom vraagt, dus de agent hoeft nooit een Google-inloggegeven, een databasewachtwoord of een poortnummer te hanteren. Wat terugkomt, is een resultaat. Schrijven vereist een beschrijfbare verbinding en de instelling Agenten schrijfrechten geven, standaard uit.
Een agent die debugt tegen een productiereplica leest de rijen die de bug verklaren, zonder inloggegeven dat in zijn context kan lekken en zonder pad naar de database zodra de app is gesloten.
FAQ
Hoe maak ik verbinding met een Cloud SQL-instance die alleen een privé-IP heeft?
Maak een MySQL- of PostgreSQL-verbinding, kies Google Cloud SQL in Bereiken via, geef de verbindingsnaam van de instance op en vink Privé-IP aan. AgentsRoom start de Cloud SQL Auth Proxy met --private-ip op een loopback-poort en verbindt zijn client ermee. Je machine moet de VPC van de instance kunnen bereiken, bijvoorbeeld via een VPN of Interconnect.
Bewaart AgentsRoom een sleutel van een serviceaccount?
Nee. De proxy wordt geautoriseerd door de Application Default Credentials die gcloud auth application-default login op je machine heeft aangemaakt. AgentsRoom bewaart de verbindingsnaam van de instance en de twee opties, geen van beide een inloggegeven.
Kan ik verbinden zonder databasewachtwoord?
Ja, met IAM-databaseauthenticatie. Vink die aan in de verbinding en de proxy draait met --auto-iam-authn: hij logt in met je Google-identiteit, het wachtwoordveld verdwijnt en de gebruiker is je IAM-databasegebruiker. De instance moet IAM-authenticatie hebben ingeschakeld en die gebruiker moet bestaan.
Wat moet ik geïnstalleerd hebben?
De Cloud SQL Auth Proxy, versie 2 (gcloud components install cloud-sql-proxy, of de losse download van Google), en een gcloud-login voor de Application Default Credentials. gcloud zelf is alleen nodig voor de knop Mijn instanties tonen.
Wat gebeurt er als mijn gcloud-login verloopt?
De proxy weigert de verbinding en logt de reden. AgentsRoom leest dat log en toont een duidelijke melding die zegt dat je gcloud auth application-default login moet uitvoeren, in plaats van een kale verbindingsfout. Daarna probeer je het opnieuw.
Welke lokale poort wordt gebruikt, en wie kan erbij?
Het besturingssysteem kiest een vrije poort wanneer de verbinding opent, en de proxy luistert alleen op 127.0.0.1. Niets op het lokale netwerk kan erbij, en de proxy stopt zodra de verbinding sluit of de app wordt afgesloten.
Welke Cloud SQL-engines worden ondersteund?
Cloud SQL voor MySQL en Cloud SQL voor PostgreSQL. Cloud SQL voor SQL Server wordt niet ondersteund omdat AgentsRoom nog geen SQL Server-client heeft; vraag ernaar op de openbare backlog en het wordt meegeteld.
Werkt het op Windows en Linux?
Ja. cloud-sql-proxy is een native binary op macOS, Windows en Linux, en AgentsRoom start hem op alle drie op dezelfde manier. De app op je telefoon toont dezelfde verbindingen en bevraagt ze alleen-lezen via je desktop.
Kan een AI-agent de database bevragen via de proxy?
Ja, standaard alleen-lezen. Een agent noemt een opgeslagen verbinding via de MCP van AgentsRoom, de app start de proxy en voert het statement zelf uit, en alleen het resultaat reist terug. De agent krijgt nooit een Google-inloggegeven of databasewachtwoord, en db_query weigert alles behalve een leesopdracht, tenzij de verbinding beschrijfbaar is en je Agenten schrijfrechten geven ervoor hebt ingeschakeld.
Je vindt misschien ook leuk
Databaseverbindingen
Bewaar je MySQL-, PostgreSQL- en MongoDB-verbindingen, bereik een database in een privaat subnet via een SSH-tunnel of een AWS SSM-sessie, en laat je AI-agenten er via MCP query's op uitvoeren. Standaard alleen-lezen, één statement per aanroep, begrensde resultaatsets, en het wachtwoord bereikt de agent nooit. Exporteren, importeren en een database over een andere heen kopiëren zitten erbij.
RDS via AWS SSM
Bereik vanaf je eigen machine een Amazon RDS-instance zonder publiek eindpunt, via aws ssm start-session en het document AWS-StartPortForwardingSessionToRemoteHost. Geen bastion om te onderhouden, geen VPN, geen inkomende SSH-regel. AgentsRoom opent de sessie op een loopback-poort en verbindt de databaseclient daardoorheen. MySQL, PostgreSQL en MongoDB, dus RDS MySQL, RDS PostgreSQL, Aurora en DocumentDB.
Geheimenbeheer
Bewaar API-sleutels, tokens en wachtwoorden in de sleutelhanger van je besturingssysteem, verwijs ernaar met {{secret:NAME}} in dev-commando's en agentomgevingen, en laat AgentsRoom ze invullen bij het starten. Agenten zien de namen, nooit de waarden, en er wordt niets naar een server gesynchroniseerd.
SSH-verbindingen
Bewaar je SSH-verbindingen, open een ingebouwde terminal via SSH, en voer Claude Code, Codex of Antigravity CLI direct uit op je externe server of VPS. SSH-sleutel of wachtwoordauthenticatie, verbindingprofielen per project, geen aparte SSH-client nodig.
Bevraag je private Cloud SQL-instance
Download AgentsRoom, kies je Cloud SQL-instance en bevraag hem via de Cloud SQL Auth Proxy met je eigen gcloud-login: geen bastion-VM, geen publiek IP, geen sleutel op schijf.
Companion-app: houd je agents onderweg in de gaten
Breng je eigen: Claude, Codex, Antigravity CLI of andere AI-provider.
Stuur bugs en verzoeken direct naar je openbare backlog.