Bronnen koppelen

Bronnen koppelen

Koppel je clouds, directory's en CMDB aan MESH, zodat je register van bedrijfsmiddelen zichzelf vult en actueel houdt. Deze pagina legt uit hoe je elke bron koppelt, hoe je een koppeling controleert en ververst, en precies waar Soveryne wel en geen toegang toe heeft.

Alleen een Beheerder van de MESH-werkruimte kan bronnen koppelen en beheren.

Wat je kunt koppelen

BronWat MESH leest
Microsoft AzureCloudresources en toegang
Microsoft Entra directoryMensen, groepen en workload-identiteiten
Amazon Web ServicesResources, IAM en Identity Center
Google CloudResources, serviceaccounts en toegang
Google directoryWorkspace-gebruikers, groepen en lidmaatschappen
ServiceNowCMDB-bedrijfsmiddelen en relaties

Cloudresources en directory's zijn aparte koppelingen. Wil je zowel je Azure-resources als je Entra-gebruikers importeren, koppel dan na elkaar Microsoft Azure en Microsoft Entra directory. Hetzelfde geldt voor Google Cloud en Google directory.

Hoe het werkt

Je logt in op de eigen inlogpagina van de provider (of keurt bij AWS een stack goed in je AWS-console). Je typt nooit een wachtwoord of sleutel in MESH.
MESH toont de accounts die de inlog kan zien, bijvoorbeeld je Azure-abonnementen. Jij kiest welke worden geïmporteerd.
MESH controleert of het elk account kan lezen en start daarna direct de eerste import.
Daarna ververst MESH elke gekoppelde bron elk uur.
MESH leest alleen. Het maakt, wijzigt of verwijdert nooit iets bij de bron.

Voordat je begint

Zorg dat een beheerder van de provider beschikbaar is. Zie Wat elke bron nodig heeft.
Sta toe dat je browser een nieuw tabblad voor MESH opent: de AWS-koppeling opent er een.
Als een provider in het koppelingsvenster Unavailable toont, met "Not available in this workspace yet. Ask your service provider to enable" en de naam van de provider, dan is die provider nog niet voor je werkruimte ingericht. Neem contact op met Soveryne of je Soveryne-partner.

Een bron koppelen

1
Selecteer Connected sources in de navigatie.
2
Selecteer Connect source (of Connect a source als je nog geen koppelingen hebt).
3
Het venster Connect a source toont de providers: "Choose a provider. Sign in to discover your accounts and verify inventory access." Selecteer Connect bij de provider die je wilt.
4
Log in zoals hieronder voor je provider is beschreven.
5
Terug in MESH toont het venster "Checking authorization…".
6
Als de inlog meer dan één account kan zien, meldt MESH "Choose the accounts to import." Vink de accounts aan en selecteer Connect selected accounts. Bij maar één account koppelt MESH dat direct.
7
Voor elk account toont MESH "Verifying inventory access for" en de naam van het account.

Als het klaar is, toont MESH dat het account is gekoppeld: "The first sync is starting. MESH refreshes authorized inventory hourly." De bron verschijnt als kaart op Connected sources.

Als er iets misgaat, toont het venster de reden en een knop Retry connection.

Microsoft Azure en Microsoft Entra directory

1
Selecteer Connect bij Microsoft Azure of Microsoft Entra directory.
2
Je browser gaat naar de inlogpagina van Microsoft. Log in met een account in de Microsoft-tenant van je organisatie.
3
Microsoft vraagt je Soveryne toegang te geven. Bekijk de machtigingen en accepteer. Voor Microsoft Entra directory moet een beheerder accepteren die namens de organisatie toestemming mag geven.
4
Microsoft stuurt je terug naar MESH. Ga verder bij stap 5 van Een bron koppelen.

Voor Microsoft Azure importeert MESH de abonnementen die het kan lezen. Meldt de kaart later dat er geen abonnement leesbaar is, wijs dan de rol Reader op je abonnementen toe aan de applicatie van Soveryne en selecteer daarna Verify connection.

Amazon Web Services

1
Selecteer Connect bij Amazon Web Services.
2
Er opent een nieuw tabblad met de AWS CloudFormation-console en een voorbereide stack. De naam begint met SoveryneMesh-. Opent er geen tabblad, dan meldt MESH "Allow a new tab to open, then choose Connect again."
3
Log, als daarom wordt gevraagd, in bij AWS in het account dat je wilt importeren.
4
Bekijk de stack en maak die aan. Die maakt één alleen-lezen IAM-rol aan, SoveryneCensusReader, met de policy SoveryneCensusRead. Alleen Soveryne kan deze rol gebruiken, en alleen met een external ID dat uniek is voor jouw koppeling.
5
Laat het MESH-venster open. Daarin staat "Approve the inventory role in AWS. MESH will detect completion automatically." MESH merkt wanneer de stack klaar is en gaat vanzelf verder.

MESH vindt je resources via AWS Resource Explorer. Zet Resource Explorer aan met een aggregator-index, zodat MESH resources in elke Region kan zien. Zonder die index ziet MESH hooguit één Region.

Gebruik je AWS IAM Identity Center buiten de standaard-Region, stel dan daarna de Region in:

1
Selecteer op Connected sources de optie Manage connection op de AWS-kaart.
2
Selecteer Identity Center region.
3
Vul de Region in bij AWS Identity Center region (bijvoorbeeld eu-west-1) en selecteer Save region.
4
MESH toont "Region saved. Refresh the source to verify directory coverage." Selecteer Refresh now op de kaart.

Google Cloud en Google directory

1
Selecteer Connect bij Google Cloud of Google directory.
2
Je browser gaat naar de inlogpagina van Google. Log in met een account in je organisatie.
3
Google vraagt je Soveryne toegang te geven. Bekijk het verzoek en sta het toe.
4
Google stuurt je terug naar MESH. Ga verder bij stap 5 van Een bron koppelen.

Voor Google directory is een Google Workspace-beheerder nodig. Met een ander account meldt MESH "Google directory administrator access is required."

ServiceNow

Het adres van je ServiceNow-instance wordt door Soveryne voor je werkruimte ingericht. Geef eerst de naam van je instance (<name>.service-now.com) door aan Soveryne of je partner.

1
Selecteer Connect bij ServiceNow.
2
Je browser gaat naar de inlogpagina van je ServiceNow-instance. Log in met een account dat je CMDB kan lezen, en sta toegang toe.
3
ServiceNow stuurt je terug naar MESH. Ga verder bij stap 5 van Een bron koppelen.

De status van je bronnen controleren

Connected sources toont één kaart per koppeling. Het overzicht bovenaan vermeldt hoeveel koppelingen worden getoond en of "All connections verified", of hoeveel er aandacht nodig hebben. Gebruik Search connections… om een koppeling te vinden op accountnaam of provider.

De pagina Connected sources met een kaart per koppeling, de status en de laatste en volgende synchronisatie

Elke kaart toont de provider, de accountnaam en een statuslabel:

LabelBetekenis
ConnectedGeverifieerd en importeert elk uur.
SyncingEr loopt nu een import.
Needs verificationMESH heeft deze koppeling nog niet geverifieerd, dus importeert het niet. Selecteer Verify connection.
Needs attentionEr is iets misgegaan, bijvoorbeeld omdat de toegang is ingetrokken. De kaart zegt wat.

De kaart toont ook Last successful sync en Next sync. Open Inventory coverage om te zien wat MESH uit deze bron kan lezen, bijvoorbeeld Assets, People and groups, Workload identities of Resource access. Bij elk item staat of het Available, Stale, Incomplete of Not supported is, hoeveel actieve records het bevat en, als er iets ontbreekt, waarom.

Verifiëren, verversen en opnieuw koppelen

Elke kaart heeft één hoofdknop, die afhangt van de status:

Verify connection: controleert of MESH de bron kan lezen. Een geverifieerde koppeling begint direct met importeren en daarna elk uur.
Refresh now: start nu een import, in plaats van te wachten op de volgende uurlijkse import. MESH meldt "Refresh requested. Inventory updates after the run completes."

Selecteer Manage connection om de details van de koppeling te openen: de synchronisatietijden, scope, dekking en wanneer de koppeling het laatst is geverifieerd. Daar vind je ook:

Reconnect: opnieuw inloggen, bijvoorbeeld nadat de toegang bij de provider is verlopen. Log in met hetzelfde account; MESH weigert een ander account ("Reconnect the same account, or connect this account as a new source."). Alleen de beheerder die de bron heeft gekoppeld, kan die opnieuw koppelen.
Verify grant: controleert de toegang opnieuw.
Import now: start een import, net als Refresh now op de kaart. Dit is alleen beschikbaar voor een geverifieerde koppeling.
Identity Center region: alleen voor AWS, zie hierboven.
Remove source: zie de volgende sectie.

Terwijl er een import loopt, kun je de bron in MESH niet wijzigen. Wacht tot die klaar is.

Een bron verwijderen

1
Selecteer op de kaart van de bron Manage connection.
2
Selecteer Remove source.
3
Lees "What happens next": "Synchronization stops and the connection is removed from MESH. Collected inventory stays available as stale data."
4
Wil je ook de inventaris wissen, vink dan Also remove collected inventory aan. Dit wist de inventaris en de waarnemingen van bedrijfsmiddelen van de bron; je eigen velden en de geschiedenis blijven. MESH waarschuwt: "Inventory cleanup cannot be undone."
5
Selecteer Remove source.

De bron verdwijnt uit de lijst. De toegang van Soveryne via deze koppeling wordt ingetrokken, tenzij een andere koppeling van jou dezelfde inlog gebruikt.

Waar Soveryne wel en geen toegang toe heeft

Soveryne kan:

de inventaris lezen die elke bron aanbiedt, zoals vermeld in Wat je kunt koppelen;
voor Microsoft Entra directory: gebruikers, groepslidmaatschappen, applicaties en directoryrollen lezen;
voor Google directory: de gebruikers, groepen en groepsleden van je organisatie lezen, met alleen leestoegang;
voor AWS: de alleen-lezen rol SoveryneCensusReader gebruiken die jij hebt aangemaakt, en alleen met het external ID daarvan.

Soveryne kan niet:

iets maken, wijzigen of verwijderen in je clouds, directory's of CMDB. MESH leest alleen;
je wachtwoorden of sleutels zien. Je logt in op de eigen pagina van de provider; MESH accepteert alleen de echte inlogadressen van de provider, en er komen geen inloggegevens van bronnen in je browser terecht;
een bron blijven lezen nadat je de toegang bij de provider hebt ingetrokken.

Toegang intrekken kan op elk moment:

verwijder de bron in MESH, zie Een bron verwijderen; en
bij de provider: verwijder de applicatie van Soveryne uit je Microsoft- of Google-tenant, verwijder de stack SoveryneMesh- in AWS CloudFormation, of trek de toegang in ServiceNow in.

Wat elke bron nodig heeft

BronWat je nodig hebt
Microsoft AzureEen account in je Microsoft-tenant dat toestemming kan geven aan de applicatie van Soveryne, en de rol Reader voor de applicatie van Soveryne op de abonnementen die je wilt importeren.
Microsoft Entra directoryEen beheerder die namens je organisatie toestemming kan geven.
Amazon Web ServicesRechten om een CloudFormation-stack met een IAM-rol aan te maken, en Resource Explorer aangezet met een aggregator-index.
Google CloudEen account in je organisatie met leestoegang tot de projecten die je wilt importeren.
Google directoryEen Google Workspace-beheerder.
ServiceNowDe naam van je instance, vooraf doorgegeven aan Soveryne, en een account dat de CMDB kan lezen.

Zie ook de Onboardingchecklist.

Problemen oplossen

MeldingWat het betekentWat je doet
Unavailable bij een provider, met "Not available in this workspace yet. Ask your service provider to enable" en de naam van de providerDeze provider is niet ingericht voor je werkruimte.Neem contact op met Soveryne of je Soveryne-partner.
"Authorization was cancelled. You can connect again."Je hebt geannuleerd op de inlogpagina van de provider.Selecteer opnieuw Connect.
"Authorization expired or was already used. Connect again."Het inloggen duurde te lang, of de inlog was al gebruikt.Selecteer opnieuw Connect.
"No inventory accounts are accessible with this login."Het account waarmee je inlogde, kan geen abonnement, project of account zien.Log in met een account dat toegang heeft.
"The previously connected account is not accessible with this login. Sign in with an account that has access."Bij het opnieuw koppelen heb je ingelogd met een account dat het gekoppelde account niet kan zien.Koppel opnieuw met het juiste account.
"This authorization belongs to another administrator."Een andere beheerder heeft deze bron gekoppeld.Vraag die beheerder om de bron opnieuw te koppelen.
"Provider access expired or was revoked. Reconnect this source."De provider accepteert de toegang van Soveryne niet meer.Selecteer Manage connection › Reconnect.
"Verify this source before starting an import."De koppeling is niet geverifieerd.Selecteer Verify connection.
"Wait for the current import to finish before changing this source."Er loopt een import.Wacht tot de kaart niet meer Syncing toont.
"Allow a new tab to open, then choose Connect again."Je browser heeft het AWS-tabblad geblokkeerd.Sta pop-ups voor MESH toe en selecteer opnieuw Connect.
"Google directory administrator access is required."Het Google-account is geen Workspace-beheerder.Log in als Google Workspace-beheerder.
"Connections could not be loaded"MESH kon je koppelingen niet ophalen. Je koppelingen en inventaris blijven bewaard.Selecteer Try again.