> For the complete documentation index, see [llms.txt](https://docs.stoik.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stoik.io/help/help-de/menschliche-sicherheit/permissions.md).

# Berechtigungen

Human Security schützt Ihre Mitarbeitenden vor Phishing, Betrug und Kontenkompromittierung. Um echte Bedrohungen zu stoppen und sie nicht nur zu markieren, benötigt Stoïk einen definierten Satz an Berechtigungen in Ihrem Microsoft 365 oder Google Workspace. Diese Seite erklärt jede Berechtigung, die wir anfordern, und wofür sie verwendet wird.

{% hint style="info" %}
**Unsere Grundsätze**

* **Prinzip der geringsten Berechtigung:** wir fordern nur an, was eine Funktion benötigt.
* **zweckgebunden:** jede Berechtigung ist einer bestimmten Aktion zugeordnet, unten aufgeführt.
* **Erst lesen, dann gezielt handeln:** der Großteil des Zugriffs ist schreibgeschützt; Schreibzugriff ist auf Schutzaktionen beschränkt.
* **Ihre Daten bleiben Ihre:** nie verkauft, nie über den von Ihnen aktivierten Dienst hinaus verwendet.
* **Jederzeit widerrufbar:** ziehen Sie den Zugriff jederzeit in Ihrer Admin-Konsole zurück.
  {% endhint %}

## Wie der Zugriff strukturiert ist

Human Security besteht aus drei Zugriffsblöcken. Jede Funktion nutzt nur die Blöcke, die sie benötigt, sodass Sie nur das gewähren, was Sie aktivieren.

* [Zugriff auf das Teamverzeichnis](#team-directory-access): Nur-Lesezugriff auf Ihre Mitarbeiterliste und Gruppen. Kein Postfachzugriff.
* [Postfachschutz](#mailbox-protection): Postfachzugriff, um Simulationen zuzustellen, gemeldete E-Mails zu prüfen und auf bestätigte Bedrohungen zu reagieren.
* [Melden-Button](#report-button): ein leichtgewichtiges Add-in, um verdächtige E-Mails zu markieren. Kein Postfachzugriff.

| Funktion   | Zugriff auf das Teamverzeichnis | Postfachschutz | Melden-Button |
| ---------- | :-----------------------------: | :------------: | :-----------: |
| Simulation |                ✓                |        ✓       |       ✗       |
| Lernen     |                ✓                |        ✗       |       ✗       |
| Bericht    |                ✓                |        ✓       |       ✓       |

{% hint style="success" %}
**Sie gewähren nur, was Sie nutzen.** Für Learning werden nur schreibgeschützte Verzeichniszugriffe benötigt, sonst nichts. Nur Report erfordert außerdem das Add-in, das Mitarbeitende installieren.
{% endhint %}

## Zugriff auf das Teamverzeichnis

Nur-Lesezugriff auf Ihre Mitarbeiterliste und Gruppen, damit Stoïk weiß, wen es schützen, simulieren und schulen soll. Kein Postfachzugriff.

{% tabs %}
{% tab title="Microsoft 365" %}

| Berechtigung                          | Wofür es verwendet wird                                                                                      |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **User.Read.All**                     | Benutzer lesen, um Ihre Mitarbeiterliste zu erstellen und zu aktualisieren (Namen, E-Mails, Telefonnummern). |
| **Group.Read.All**                    | Gruppen lesen, damit Sie Mitarbeitende nach Teams ansprechen und organisieren können.                        |
| **UserAuthenticationMethod.Read.All** | Die Authentifizierungsverfahren (MFA) der Mitarbeitenden lesen.                                              |
| {% endtab %}                          |                                                                                                              |

{% tab title="Google Workspace" %}

| Berechtigung                       | Wofür es verwendet wird                                                                |
| ---------------------------------- | -------------------------------------------------------------------------------------- |
| **admin.directory.user.readonly**  | Verzeichnisbenutzer lesen, um Ihre Mitarbeiterliste zu erstellen und zu aktualisieren. |
| **admin.directory.group.readonly** | Gruppen lesen, damit Sie Mitarbeitende nach Teams ansprechen und organisieren können.  |
| **userinfo.email**                 | Identifiziert den Administrator, der den Zugriff gewährt.                              |
| {% endtab %}                       |                                                                                        |
| {% endtabs %}                      |                                                                                        |

## Postfachschutz

Postfachzugriff, um Phishing-Simulationen zuzustellen, gemeldete E-Mails zu lesen und zu analysieren sowie auf bestätigte Bedrohungen zu reagieren. Sie gewähren ihn, wenn Sie Ihren Workspace für Simulation oder Report verbinden.

{% tabs %}
{% tab title="Microsoft 365" %}

| Berechtigung                                                                | Wofür es verwendet wird                                                                                                                                                                                                                                              |
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **User.Read.All**                                                           | Benutzer finden und E-Mail-Adressen den Postfächern zuordnen.                                                                                                                                                                                                        |
| **Mail.ReadWrite**                                                          | Phishing-Simulationen zustellen (einfügen, lesen, aufräumen), gemeldete E-Mails lesen und bald auf eine bestätigte Bedrohung reagieren: ein Warnbanner hinzufügen oder entfernen oder die E-Mail in einen Quarantäne-Ordner verschieben und wieder daraus entfernen. |
| **SecurityAnalyzedMessage.Read.All**                                        | Ermittelt Erkennungsdetails für eine gemeldete E-Mail, damit wir Ihrem IT-Manager sagen können, ob es sich um eine echte Bedrohung (Phishing oder Betrug) handelt.                                                                                                   |
| **AuditLog.Read.All** · **AuditLogsQuery.Read.All** · **ActivityFeed.Read** | Erkennt schädliche Aktivitäten und bestätigt, ob eine gemeldete E-Mail eine echte Bedrohung war oder zu einer Kompromittierung geführt hat.                                                                                                                          |
| **MailboxSettings.Read**                                                    | Erkennt schädliche Postfachregeln, ein häufiges Zeichen dafür, dass eine E-Mail zu einer Kontoübernahme geführt hat.                                                                                                                                                 |
| **UserAuthenticationMethod.Read.All**                                       | Erkennt Manipulationen an den MFA-Methoden eines Nutzers und zeigt den MFA-Status an.                                                                                                                                                                                |
| **Policy.Read.ConditionalAccess**                                           | Bezieht den Schutzstatus des Kontos in die Bedrohungsbewertung ein.                                                                                                                                                                                                  |
| **Application.Read.All**                                                    | Erkennt schädliche Drittanbieter-Apps, die mit einem Konto verbunden sind.                                                                                                                                                                                           |
| **Reports.Read.All**                                                        | Versteht E-Mail-Volumen und Muster, um die besten Ziele für Zahlungsbetrugs-Simulationen vorzuschlagen (Mitarbeitende, die die meisten Rechnungen erhalten, sind die realistischsten Ziele).                                                                         |
| {% endtab %}                                                                |                                                                                                                                                                                                                                                                      |

{% tab title="Google Workspace" %}

| Berechtigung                               | Wofür es verwendet wird                                                                                                                                                                                                              |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **gmail.insert**                           | Phishing-Simulations-E-Mails in Postfächer einfügen.                                                                                                                                                                                 |
| **gmail.metadata**                         | Nachrichtenköpfe und IDs lesen, um Simulationen zu verifizieren und nachzuverfolgen.                                                                                                                                                 |
| **gmail.modify**                           | E-Mails zur Verifizierung des Simulations-Setups in den Papierkorb verschieben und bald auf eine bestätigte Bedrohung reagieren (Warnbanner, Quarantäne).                                                                            |
| **gmail.readonly**                         | Den Inhalt gemeldeter E-Mails zur Prüfung lesen und die echten Rechnungs- oder Zahlungs-E-Mails analysieren, die Mitarbeitende erhalten, um realistische Zahlungsbetrugs-Simulationen zu erstellen und die besten Ziele auszuwählen. |
| **gmail.settings.basic**                   | Allowlisting konfigurieren, damit Simulationen zuverlässig im Posteingang ankommen.                                                                                                                                                  |
| **admin.directory.user.readonly**          | Empfänger den Verzeichnisbenutzern zuordnen.                                                                                                                                                                                         |
| **admin.reports.audit.readonly**           | Verdächtige Aktivitäten erkennen, um zu bestätigen, ob eine gemeldete E-Mail eine echte Bedrohung ist, und identifizieren, wer die meisten Rechnungen erhält, um Zahlungsbetrug gezielt anzugehen.                                   |
| **apps.alerts**                            | Verwandte Google-Workspace-Sicherheitswarnungen bei der Analyse einer Bedrohung anzeigen.                                                                                                                                            |
| **admin.directory.customer.readonly**      | Organisationsdetails lesen, die zur Konfiguration des Schutzes benötigt werden.                                                                                                                                                      |
| **gmail.settings.sharing**                 | Postfach-Delegierte lesen, um Zugriffe zu erkennen, die von einem kompromittierten Konto gewährt wurden.                                                                                                                             |
| **admin.directory.device.mobile.readonly** | Die auf einem Konto registrierten Mobilgeräte lesen, um das Gerät eines Angreifers zu erkennen.                                                                                                                                      |
| {% endtab %}                               |                                                                                                                                                                                                                                      |
| {% endtabs %}                              |                                                                                                                                                                                                                                      |

{% hint style="info" %}
**Wie gemeldete E-Mails zu einem klaren Befund werden.** Wenn ein Mitarbeitender eine E-Mail meldet, analysiert Stoïk die Nachricht sowie die umgebenden Konto- und Mandantensignale, um zu entscheiden, ob es sich um echtes Phishing oder Betrug handelt, damit Ihr IT-Manager einen verlässlichen **True-/False-Positive** Befund erhält und direkt darauf reagieren kann.
{% endhint %}

## Melden-Button

Das Add-in, das Ihre Mitarbeitenden verwenden, um verdächtige E-Mails zu markieren. Es ist bewusst leichtgewichtig: Stoïk erhält dadurch keinen API-Zugriff auf Ihre Postfächer.

{% tabs %}
{% tab title="Outlook-Add-in" %}

| Berechtigung         | Wofür es verwendet wird                                                                                                  |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **ReadWriteMailbox** | Greift auf die gemeldete E-Mail zu und verschiebt sie nur, wenn der Nutzer es auswählt, in Junk oder Gelöschte Elemente. |
| **Report.Phishing**  | Melden Sie sich bei Stoïks Reporting-API an, um den Bericht zu übermitteln.                                              |
| {% endtab %}         |                                                                                                                          |

{% tab title="Gmail-Erweiterung (Chrome / Edge)" %}

| Berechtigung                                      | Wofür es verwendet wird                                                                                                                                                                                                                                         |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Identität**                                     | Öffnet die Google-Anmeldung, um zu bestätigen, welcher Nutzer den Bericht sendet.                                                                                                                                                                               |
| **Speicher**                                      | Speichert das Anmelde-Token vorübergehend zwischen und merkt sich die Konto-E-Mail-Adresse, um wiederholte Anmeldeaufforderungen zu vermeiden.                                                                                                                  |
| **`mail.google.com` (Website-Zugriff)**           | Fügt die *An Stoïk melden* Schaltfläche in Gmail hinzu, erkennt die geöffnete Nachricht und das Konto und verwendet für die resultierende Aktion die eigenen Steuerelemente von Gmail. Dies ist ein Zugriff auf die Browserseite, kein Gmail-API-OAuth-Bereich. |
| **`accounts.google.com` (Website-Zugriff)**       | Unterstützt die Google-Anmeldung.                                                                                                                                                                                                                               |
| **`*.phishing.cyber.stoik.io` (Website-Zugriff)** | Sendet den Bericht an Stoïks API.                                                                                                                                                                                                                               |
| **Anmeldebereiche: `openid`, `email`**            | Meldet den Nutzer an und identifiziert ihn per E-Mail.                                                                                                                                                                                                          |
| {% endtab %}                                      |                                                                                                                                                                                                                                                                 |
| {% endtabs %}                                     |                                                                                                                                                                                                                                                                 |

{% hint style="success" %}
**Die Gmail-Erweiterung fordert keinen OAuth-Bereich für das Postfach an.** Die Anmeldung ist auf Ihre Identität beschränkt (`openid` + `email`). Der Website-Zugriff erlaubt der Erweiterung, auf der geöffneten Gmail-Seite zu handeln; es ist kein dauerhafter serverseitiger Zugriff auf Ihr Postfach.
{% endhint %}

## Häufige Fragen

<details>

<summary>Lesen Sie alle unsere E-Mails?</summary>

Nein. Wir senden Simulations-E-Mails und lesen die konkreten Nachrichten, die Ihre Mitarbeitenden melden. Jede fortlaufende Analyse dient ausschließlich dazu, Bedrohungen zu erkennen, und nur für die von Ihnen aktivierten Funktionen.

</details>

<details>

<summary>Können wir nur einige Funktionen gewähren?</summary>

Ja. Berechtigungen sind nach Funktionen gruppiert. Wenn Sie eine Funktion nicht aktivieren, gewähren Sie auch nicht deren Berechtigungen.

</details>

<details>

<summary>Können wir den Zugriff später widerrufen?</summary>

Ja, jederzeit über Ihre Microsoft-365- oder Google-Workspace-Admin-Konsole. Durch den Widerruf des Zugriffs wird die entsprechende Funktion beendet.

</details>

<details>

<summary>Warum erlauben einige Berechtigungen Schreiben und nicht nur Lesen?</summary>

Der Schutz Ihres Teams erfordert das Handeln bei Bedrohungen, nicht nur deren Erkennung: das Zustellen einer Simulation, das Verschieben einer gemeldeten E-Mail oder das Isolieren eines bestätigten Angriffs. Schreibzugriff ist auf diese Aktionen beschränkt.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stoik.io/help/help-de/menschliche-sicherheit/permissions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
