Serviceaccounts gebruiken in Azure Managed Grafana
Artikel
In deze handleiding leert u hoe u serviceaccounts gebruikt. Serviceaccounts worden gebruikt voor het uitvoeren van geautomatiseerde bewerkingen en het verifiëren van toepassingen in Grafana met de Grafana-API.
Veelvoorkomende gebruiksvoorbeelden zijn:
Dashboards inrichten of configureren
Planningsrapporten
Waarschuwingen definiëren
Een externe SAML-verificatieprovider instellen
Interactie met Grafana zonder zich aan te melden als gebruiker
Als uw bestaande Grafana-werkruimte geen serviceaccounts heeft ingeschakeld, schakelt u deze in door de voorkeursinstellingen van uw Grafana-exemplaar bij te werken met behulp van Azure Portal of de Azure CLI.
Selecteer in Azure Portal onder Instellingen de optie Configuratie en selecteer vervolgens onder API-sleutels en serviceaccounts de optie Inschakelen.
Selecteer Opslaan om te bevestigen dat u API-sleutels en serviceaccounts wilt inschakelen in Azure Managed Grafana.
Azure Managed Grafana CLI-extensie 0.3.0 of hoger is vereist. Als u de extensie wilt bijwerken, voert u het volgende uit az extension update --name amg.
Voer de opdracht az grafana update uit om het maken van API-sleutels en serviceaccounts in een bestaand Azure Managed Grafana-exemplaar in te schakelen. Vervang in de onderstaande opdracht door <azure-managed-grafana-name> de naam van het Azure Managed Grafana-exemplaar dat u wilt bijwerken.
az grafana update --name <azure-managed-grafana-name> ---service-account Enabled
Een serviceaccount maken
Volg de onderstaande stappen om een nieuw Grafana-serviceaccount te maken en bestaande serviceaccounts weer te geven:
Ga naar het eindpunt van uw Grafana-exemplaar en selecteer vervolgens Gebruikers en toegang tot>serviceaccounts in het menu aan de linkerkant en voeg een serviceaccount toe.
Voer een weergavenaam en een rol in voor uw nieuwe Grafana-serviceaccount in de opties Geen basisrol, Viewer, Editor of Beheerder en selecteer Maken. Er is standaard geen rol toegewezen.
Zodra het serviceaccount is gemaakt, geeft Grafana informatie weer over het nieuwe serviceaccount, inclusief de aanmaakdatum, bestaande tokens en machtigingen die eraan zijn gekoppeld. In een volgende stap maakt u een eerste token.
Selecteer eventueel Serviceaccounts in het linkermenu om een lijst met alle serviceaccounts in uw Grafana-exemplaar weer te geven.
Voer de az grafana service-account create opdracht uit om een serviceaccount te maken. Vervang de tijdelijke aanduidingen <azure-managed-grafana-name><service-account-name> en <role> door uw eigen gegevens.
Beschikbare rollen: Admin, Editor, Viewer.
az grafana service-account create --name <azure-managed-grafana-name> --service-account <service-account-name> --role <role>
Voer de az grafana service-account list opdracht uit om een lijst op te halen met alle serviceaccounts die deel uitmaken van een bepaald Azure Managed Grafana-exemplaar. Vervang door <azure-managed-grafana-name> de naam van uw Azure Managed Grafana-werkruimte.
az grafana service-account list --name <azure-managed-grafana-name> --output table
Voer de az grafana service-account show opdracht uit om de details van een serviceaccount op te halen. Vervang <azure-managed-grafana-name> en <service-account-name> door uw eigen gegevens.
az grafana service-account show --name <azure-managed-grafana-name> --service-account <service-account-name>
Een serviceaccounttoken toevoegen
Nadat u een serviceaccount hebt gemaakt, voegt u een of meer toegangstokens toe. Toegangstokens worden gegenereerd die worden gebruikt voor verificatie met de Grafana-API zonder een gebruikersnaam en wachtwoord te gebruiken. Elk token is gekoppeld aan specifieke machtigingen, zodat u het toegangsniveau kunt beheren dat wordt verleend aan verschillende gebruikers of toepassingen. Tokens kunnen indien nodig worden gemaakt, beheerd en ingetrokken.
Als u een token voor een serviceaccount wilt maken, selecteert u Token voor serviceaccount toevoegen.
Gebruik de automatisch gegenereerde weergavenaam of voer een naam van uw keuze in. De vervaldatum is standaard ingesteld op één dag na de aanmaakdatum. Werk eventueel de voorgestelde vervaldatum bij of selecteer Geen vervaldatum.
Selecteer Het token genereren. Het token wordt slechts eenmaal weergegeven, dus zorg ervoor dat u het veilig kopieert en opslaat. Als u dit token kwijtraakt, moet u een nieuw token genereren.
Het token wordt nu vermeld in de details van het serviceaccount.
In de Azure CLI:
Maak een Grafana-serviceaccounttoken met az grafana service-account token create. Vervang de tijdelijke aanduidingen <azure-managed-grafana-name><service-account-name> en <token-name> door uw eigen gegevens.
U kunt desgewenst een verlooptijd instellen:
Parameter
Description
Voorbeeld
--time-to-live
Tokens hebben standaard een verlooptijd van één dag. U kunt eventueel de verlooptijd uitschakelen of bewerken om het token na een bepaalde tijd uit te schakelen. Gebruik s voor seconden, m voor minuten, h uren, d voor dagen, w voor weken, M voor maanden of y jaren.
Noteer het gegenereerde token en sla het veilig op. Als u dit token kwijtraakt, moet u een nieuw token genereren.
Voer de az grafana service-account token list opdracht uit om een lijst op te halen met alle tokens die deel uitmaken van een bepaald serviceaccount. Vervang de tijdelijke aanduidingen <azure-managed-grafana-name> en <service-account-name> door uw eigen gegevens.
az grafana service-account token list --name <azure-managed-grafana-name> --service-account <service-account-name> --output table
Voorbeeld van uitvoer:
Created Expiration HasExpired Name SecondsUntilExpiration
-------------------- -------------------- ------------ ------ ------------------------
2024-11-05T15:09:24Z 2024-11-06T14:48:51Z False token1 84388.80530215
Een serviceaccount bewerken
In deze sectie leert u hoe u een Grafana-serviceaccount bijwerkt.
Als u de naam wilt bewerken, selecteert u het serviceaccount en selecteert u Onder Gegevens bewerken.
Als u de rol wilt bewerken, selecteert u het serviceaccount en selecteert u onder Informatie de rol en kiest u een andere rolnaam.
Als u een serviceaccount wilt uitschakelen, selecteert u een serviceaccount en selecteert u boven aan de pagina Serviceaccount uitschakelen en selecteert u Vervolgens Serviceaccount uitschakelen om te bevestigen. Uitgeschakelde serviceaccounts kunnen opnieuw worden ingeschakeld door serviceaccount inschakelen te selecteren.
Het bijgewerkte meldingsserviceaccount wordt direct weergegeven.
Een serviceaccount bewerken met az grafana service-account update. Vervang de tijdelijke aanduidingen <azure-managed-grafana-name>en <service-account-name> door uw eigen gegevens en gebruik een of meer van de volgende parameters:
Parameter
Description
--is-disabled
Voer --is-disabled true een serviceaccount uit of --is-disabled false schakel een serviceaccount in.
--name
Voer een andere naam in voor uw serviceaccount.
--role
Voer een andere rol in voor uw serviceaccount. Beschikbare rollen: Admin, Editor, Viewer.
Als u een serviceaccount wilt uitschakelen, voert u de az grafana update opdracht uit en gebruikt u de optie --is-disabled true. Als u een serviceaccount wilt inschakelen, gebruikt u --is-disabled false.
az grafana update --service-account Disabled --name <service-account-name>
Als u een Grafana-serviceaccount wilt verwijderen, selecteert u een serviceaccount en selecteert u bovenaan de pagina Serviceaccount verwijderen en selecteert u Vervolgens Serviceaccount verwijderen om te bevestigen. Het verwijderen van een serviceaccount is definitief en een serviceaccount kan niet worden hersteld nadat het is verwijderd.
Als u een serviceaccount wilt verwijderen, voert u de az grafana service-account delete opdracht uit. Vervang de tijdelijke aanduidingen <azure-managed-grafana-name> en <service-account-name> door uw eigen gegevens.
az grafana service-account delete --name <azure-managed-grafana-name> --service-account <service-account-name>
Als u een token voor een serviceaccount wilt verwijderen, selecteert u een serviceaccount en selecteert u onder Tokens verwijderen (x). Selecteer Verwijderen om te bevestigen.
Als u een serviceaccount wilt verwijderen, voert u de az grafana service-account token delete opdracht uit. Vervang de tijdelijke aanduidingen <azure-managed-grafana-name><service-account-name> en <token-name> door uw eigen gegevens.
In deze handleiding hebt u geleerd hoe u serviceaccounts en tokens maakt en beheert om geautomatiseerde bewerkingen uit te voeren in Azure Managed Grafana. Wanneer u klaar bent, bekijkt u meer artikelen:
