{"meta":{"title":"Verwalten von Unternehmenskonten","intro":"Du kannst dein Unternehmenskonto und die zugehörigen Organisationen mit der GraphQL-API verwalten.","product":"GraphQL-API","breadcrumbs":[{"href":"/de/enterprise-server@3.21/graphql","title":"GraphQL-API"},{"href":"/de/enterprise-server@3.21/graphql/guides","title":"Anleitungen"},{"href":"/de/enterprise-server@3.21/graphql/guides/managing-enterprise-accounts","title":"Verwalten von Unternehmenskonten"}],"documentType":"article"},"body":"# Verwalten von Unternehmenskonten\n\nDu kannst dein Unternehmenskonto und die zugehörigen Organisationen mit der GraphQL-API verwalten.\n\n## Informationen zum Verwalten von Unternehmenskonten mit GraphQL\n\nDu kannst die Unternehmenskonten-API und die Überwachungsprotokoll-API verwenden, die nur als GraphQL-APIs verfügbar sind, um Änderungen in deiner Organisation zu überwachen und vorzunehmen sowie konform zu bleiben.\n\nDie Endpunkte des Unternehmenskontos funktionieren sowohl für GitHub Enterprise Cloud als auch für GitHub Enterprise Server.\n\nMit GraphQL kannst du nur die von dir angegebenen Daten anfordern und zurückgeben. Beispielsweise kannst du eine GraphQL-Abfrage erstellen oder Informationen anfordern, um alle neuen Organisationsmitglieder anzuzeigen, die deiner Organisation hinzugefügt wurden. Alternativ kannst du eine Änderung vornehmen, um einen Administrator zu deinem Unternehmenskonto einzuladen.\n\nMit der Überwachungsprotokoll-API kannst du überwachen, ob jemand:\n\n* auf deine Organisations- oder Repositoryeinstellungen zugreift\n* Ändert Berechtigungen.\n* Benutzer in einer Organisation, einem Repository oder einem Team hinzufügt oder daraus entfernt.\n* Benutzer zum Administrator heraufstuft.\n* Ändert die Berechtigungen einer GitHub App.\n\nMit der Überwachungsprotokoll-API kannst du Kopien deiner Überwachungsprotokolldaten aufbewahren. Bei Abfragen, die mit der Überwachungsprotokoll-API durchgeführt werden, kann die GraphQL-Antwort Daten für 90 bis 120 Tage enthalten. Eine Liste der Felder, die mit der Überwachungsprotokoll-API verfügbar sind, findest du unter [Enterprise-Verwaltung](/de/enterprise-server@3.21/graphql/reference/enterprise-admin#interface-auditentry).\n\nMit der Unternehmenskonten-API kannst du Folgendes durchführen:\n\n* Alle Organisationen und Repositorys auflisten und überprüfen, die zu deinem Unternehmenskonto gehören\n* Die Einstellungen des Unternehmenskontos ändern\n* Richtlinien für die Einstellungen deines Unternehmenskontos und die zugehörigen Organisationen konfigurieren\n* Administrator\\*innen zu deinem Unternehmenskonto einladen\n* Neue Organisationen in deinem Unternehmenskonto erstellen\n\nEine Liste der felder, die mit der Enterprise-Konten-API verfügbar sind, finden Sie unter [Verwalten von Unternehmenskonten](/de/enterprise-server@3.21/graphql/guides/managing-enterprise-accounts#graphql-fields-and-types-for-the-enterprise-accounts-api).\n\n## Einführung in die Verwendung von GraphQL für Unternehmenskonten\n\nUm zu beginnen, wie Sie mit GraphQL Ihre Enterprise-Konten verwalten, siehe [Verwenden von GraphQL-Clients](/de/enterprise-server@3.21/graphql/guides/using-graphql-clients).\n\nEinige Beispielabfragen findest du unter [Eine Beispielabfrage, bei der die Unternehmenskonten-API verwendet wird](#an-example-query-using-the-enterprise-accounts-api).\n\n### 1. Melden Sie sich mit Ihrem personal access token an.\n\n1. Um sich mit GraphQL zu authentifizieren, müssen Sie eine personal access token aus den Entwicklereinstellungen generieren. Weitere Informationen finden Sie unter [Verwalten deiner persönlichen Zugriffstoken](/de/enterprise-server@3.21/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).\n\n2. Gewähren Sie Ihrem personal access token Administrator- und Vollzugriffsrechte für die Bereiche Ihres Unternehmens, auf die Sie zugreifen möchten. Für den vollständigen Zugriff auf private Repositories, Organisationen, Teams, Benutzerdaten sowie Abrechnungs- und Profildaten von Unternehmen empfehlen wir, für Ihre personal access token diese Berechtigungsumfänge auszuwählen:\n\n * `repo`\n * `admin:org`\n * `user`\n * `admin:enterprise`\n\n Die spezifischen Bereiche des Unternehmenskontos sind:\n\n * `admin:enterprise`: Bietet vollständige Kontrolle über Unternehmen (beinhaltet `manage_runners:enterprise`, `manage_billing:enterprise` und `read:enterprise`)\n * `manage_billing:enterprise`: Lesen und Schreiben von Enterprise-Abrechnungsdaten.\n * `manage_runners:enterprise`: Zugriff auf die Verwaltung von GitHub Actions-Enterprise-Runnern und Runner-Gruppen.\n * `read:enterprise`: Unternehmensprofildaten lesen.\n\n3. Kopieren Sie Ihre Datei personal access token , und bewahren Sie sie an einem sicheren Ort auf, bis Sie sie ihrem GraphQL-Client hinzufügen.\n\n### 2. Wähle einen GraphQL-Client aus.\n\nEs wird empfohlen, GraphiQL oder einen anderen eigenständigen GraphQL-Client zu verwenden, mit dem du die Basis-URL konfigurieren kannst.\n\nAlternativ kannst du diese GraphQL-Clients verwenden:\n\n* [Insomnia](https://support.insomnia.rest/article/176-graphql-queries)\n* [GraphiQL](https://www.gatsbyjs.org/docs/running-queries-with-graphiql/)\n* [Postman](https://learning.getpostman.com/docs/postman/sending_api_requests/graphql/)\n\nIn den nächsten Schritten wird Insomnia verwendet.\n\n### 3. Einrichtung von Insomnia für die Verwendung der GitHub GraphQL-API mit Unternehmenskonten\n\n1. Füge dem GraphQL-Client die Basis-URL und die `POST`-Methode hinzu. Wenn Sie GraphQL verwenden, um Informationen (Abfragen), Änderungsinformationen (Mutationen) anzufordern oder Daten mithilfe der GitHub-API zu übertragen, ist die standardmäßige HTTP-Methode `POST` und die Basis-URL folgt dieser Syntax:\n * Für deine Unternehmensinstanz: `https:///api/graphql`\n * Für GitHub Enterprise Cloud: `https://api.github.com/graphql`\n * Für GitHub Enterprise Cloud mit Datenresidenz: `https://api.SUBDOMAIN.ghe.com/graphql`\n\n2. Wähle das Menü „Auth“ und dann **Bearer Token** aus. Wenn du zuvor eine andere Authentifizierungsmethode ausgewählt hast, wird das Menü stattdessen mit dieser Methode beschriftet (z. B. „Basic Auth“).\n\n![Screenshot des erweiterten Menüs „Auth“ in Insomnia. Die Menübezeichnung „Auth“ und die Option „Bearer Token“ sind dunkel orange umrandet.](/assets/images/developer/graphql/insomnia-bearer-token-option.png)\n\n1. Geben Sie im Feld \"TOKEN\" Ihren personal access token aus einem früheren Schritt ein.\n\n![Screenshot der Authentifizierungseinstellungen unter „Bearer“ in Insomnia. Das Feld „TOKEN“ ist dunkelorange umrandet.](/assets/images/developer/graphql/insomnia-base-url-and-pat.png)\n\n1. Wähle **Headers** aus.\n\n![Screenshot der Einstellungsregisterkarten in Insomnia. Der Tab „Headers“ ist dunkelorange umrandet.](/assets/images/developer/graphql/json-content-type-header.png)\n\n1. Wählen auf der Registerkarte **Headers** die Option **Add** aus.\n2. Gib `Content-Type` in das Feld „Header“ ein.\n3. Gib `application/json` in das Feld „Value“ ein.\n\nNun kannst du Abfragen tätigen.\n\n## Eine Beispielabfrage, bei der die Unternehmenskonten-API verwendet wird\n\nDiese GraphQL-Abfrage fragt die Gesamtanzahl der `public`-Repositorys in allen Organisationen deiner Anwendung mithilfe der Enterprise–Konto-API ab. Ersetzen Sie `` durch den Bezeichner Ihres Unternehmenskontos, um diese Abfrage anzupassen. Wenn sich Ihr Unternehmenskonto beispielsweise unter `https://github.com/enterprises/octo-enterprise` befindet, ersetzen Sie `` durch `octo-enterprise`.\n\n```graphql\nquery publicRepositoriesByOrganization($slug: String!) {\n enterprise(slug: $slug) {\n ...enterpriseFragment\n }\n}\n\nfragment enterpriseFragment on Enterprise {\n ... on Enterprise{\n name\n organizations(first: 100){\n nodes{\n name\n ... on Organization{\n name\n repositories(privacy: PUBLIC){\n totalCount\n }\n }\n }\n }\n }\n}\n\n# Passing our Enterprise Account as a variable\nvariables {\n \"slug\": \"\"\n}\n```\n\nBei der nächsten GraphQL-Abfrage wird gezeigt, wie schwierig es ist, die Anzahl von `public`-Repositorys in jeder Organisation abzurufen, ohne die Unternehmenskonten-API zu verwenden. Beachte, dass die Unternehmenskonten-API für GraphQL diese Aufgabe für Unternehmen vereinfacht hat, da du nur eine einzelne Variable anpassen musst. Ersetze `` und `` usw. durch die Organisationsnamen in deiner Instanz, um diese Abfrage anzupassen.\n\n```graphql\n# Each organization is queried separately\n{\n organizationOneAlias: organization(login: \"nameOfOrganizationOne\") {\n # How to use a fragment\n ...repositories\n }\n organizationTwoAlias: organization(login: \"nameOfOrganizationTwo\") {\n ...repositories\n }\n # organizationThreeAlias ... and so on up-to lets say 100\n}\n\n## How to define a fragment\nfragment repositories on Organization {\n name\n repositories(privacy: PUBLIC){\n totalCount\n }\n}\n```\n\n## Jede Organisation einzeln abfragen\n\n```graphql\nquery publicRepositoriesByOrganization {\n organizationOneAlias: organization(login: \"\") {\n # How to use a fragment\n ...repositories\n }\n organizationTwoAlias: organization(login: \"\") {\n ...repositories\n }\n # organizationThreeAlias ... and so on up-to lets say 100\n}\n# How to define a fragment\nfragment repositories on Organization {\n name\n repositories(privacy: PUBLIC){\n totalCount\n }\n}\n```\n\nDie GraphQL-Abfrage fordert die letzten fünf Protokolleinträge einer Unternehmensorganisation an. Ersetze `` und ``, um diese Abfrage anzupassen.\n\n```graphql\n{\n organization(login: \"\") {\n auditLog(last: 5, query: \"actor:\") {\n edges {\n node {\n ... on AuditEntry {\n# Get Audit Log Entry by 'Action'\n action\n actorLogin\n createdAt\n# User 'Action' was performed on\n user{\n name\n email\n }\n }\n }\n }\n }\n }\n}\n```\n\nWeitere Informationen zur Einführung in GraphQL finden Sie unter [Einführung in GraphQL](/de/enterprise-server@3.21/graphql/guides/introduction-to-graphql) und [Erstellen von Aufrufen mit GraphQL](/de/enterprise-server@3.21/graphql/guides/forming-calls-with-graphql).\n\n## GraphQL-Felder und -Typen für die Unternehmenskonten-API\n\nWeitere Informationen zu den neuen Abfragen, Änderungen und schemadefinierten Typen, die mit der Unternehmenskonten-API verwendet werden können, findest du auf der Randleiste mit den detaillierten GraphQL-Definitionen auf jeder [Referenzseite zu GraphQL](/de/enterprise-server@3.21/graphql).\n\nSie können über die GraphQL-Clients auf die Referenzdokumente zugreifen. Weitere Informationen finden Sie unter [Verwenden von GraphQL-Clients](/de/enterprise-server@3.21/graphql/guides/using-graphql-clients).\nWeitere Informationen, z. B. Authentifizierungs- und Zinslimitdetails, finden Sie im [guides](/de/enterprise-server@3.21/graphql/guides)."}