> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 1Password

> Anmeldeversuche, Audit-Ereignisse und Elementnutzung in Ihrem 1Password-Konto überwachen

Mit der 1Password-Integration können Sie sicherheitsrelevante Ereignisse aus Ihrem 1Password-Konto erfassen, darunter:

* **Anmeldeversuche**: Verfolgen Sie erfolgreiche und fehlgeschlagene Authentifizierungsversuche
* **Audit-Ereignisse**: Überwachen Sie administrative Aktionen und Konfigurationsänderungen
* **Elementnutzung**: Sehen Sie, wann auf Zugangsdaten und Geheimnisse zugegriffen wird

## Voraussetzungen

Stellen Sie vor der Einrichtung dieser Integration sicher, dass Sie über Folgendes verfügen:

1. Ein Konto vom Typ 1Password Business oder 1Password Teams
2. Owner- oder Administratorrechte in Ihrem 1Password-Konto
3. Zugriff auf die 1Password Admin Console

## Schritt 1: Eine Events-Reporting-Integration erstellen

1. Melden Sie sich bei Ihrer [1Password Admin Console](https://start.1password.com/) an
2. Navigieren Sie in der Seitenleiste zu **Integrations**
3. Klicken Sie oben auf **Directory**
4. Suchen Sie nach **Events Reporting** und wählen Sie „Other“ aus
5. Klicken Sie auf **Add Integration**
6. Geben Sie Ihrer Integration einen aussagekräftigen Namen (z. B. „Wirespeed Events Integration“)
7. Klicken Sie auf **Save**

## Schritt 2: Ein Bearer-Token generieren

Nach dem Erstellen der Integration:

1. Sie sehen einen Abschnitt **Set up token**
2. Klicken Sie auf **Generate token** (oder auf **Regenerate token**, falls bereits eines existiert)
3. Wählen Sie unter **Events to Report** alle drei Ereignistypen aus:
   * Sign-in attempts
   * Item usages
   * Audit events
4. **Wichtig**: Kopieren Sie das Token sofort und speichern Sie es sicher. Sie können es später nicht erneut einsehen.
5. Das Token sieht etwa so aus: `eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`

> [!WARNING]
>
> Bewahren Sie Ihr Bearer-Token sicher auf. Wenn Sie es verlieren, müssen Sie ein neues generieren, wodurch das alte Token ungültig wird.

> [!NOTE]
>
> Jeder Ereignistyp ist eine eigene Token-Funktion. Wenn Sie einen auslassen, stellt Wirespeed trotzdem eine Verbindung her und erfasst die ausgewählten Typen. Die fehlende Funktion wird auf der Integrationsseite als Berechtigungswarnung angezeigt und nicht als wiederkehrender Fehler.

## Schritt 3: Ihre Server-URL ermitteln

1Password verwendet je nach Kontotyp und Region unterschiedliche Server-URLs. Verwenden Sie die passende URL:

| Kontotyp | Server-URL |
| - | - |
| 1Password Business (USA) | `https://events.1password.com` |
| 1Password Business (Kanada) | `https://events.1password.ca` |
| 1Password Business (EU) | `https://events.1password.eu` |
| 1Password Enterprise | `https://events.ent.1password.com` |

> [!TIP]
>
> Wenn Sie nicht sicher sind, welchen Server Sie verwenden sollen, prüfen Sie Ihre 1Password-Anmelde-URL. Wenn Sie sich unter `my.1password.ca` anmelden, verwenden Sie den Server für Kanada (`events.1password.ca`).

## Schritt 4: Die Integration in Wirespeed hinzufügen

1. Melden Sie sich bei Wirespeed an und navigieren Sie zu Integrationen > [**Integration hinzufügen**](https://app.wirespeed.co/settings/integrations?tab=browse)
2. Suchen Sie nach **1Password Events API** und wählen Sie es aus
3. Geben Sie die folgenden Informationen ein:
   * **Server-URL**: Die passende Server-URL aus Schritt 3
   * **API-Token**: Das Bearer-Token, das Sie in Schritt 2 generiert haben
4. Klicken Sie auf **Integrieren**, um die Einrichtung abzuschließen

## Welche Ereignisse werden erfasst?

### Anmeldeversuche

Diese Ereignisse verfolgen Authentifizierungsversuche bei Ihrem 1Password-Konto, darunter:

* Erfolgreiche Anmeldungen
* Fehlgeschlagene Authentifizierungsversuche
* MFA-Abfragen
* Durch Richtlinien blockierte Anmeldeversuche

### Audit-Ereignisse

Administrations- und Konfigurationsereignisse, darunter:

* Benutzerverwaltung (Einladungen, Entfernungen, Rollenänderungen)
* Erstellung von Tresoren und Änderungen von Berechtigungen
* Gruppenverwaltung
* Richtlinienänderungen
* Einrichtung von Integrationen

### Elementnutzung

Ereignisse, die zeigen, wann auf Geheimnisse zugegriffen wird:

* Anzeigen von Zugangsdaten
* Kopieren von Passwörtern
* Nutzung von Autofill
* Exporte von Elementen

## Fehlerbehebung

### Authentifizierungsfehler

Wenn Authentifizierungsfehler angezeigt werden:

1. Prüfen Sie, ob Ihr Bearer-Token korrekt und nicht abgelaufen ist
2. Stellen Sie sicher, dass Sie die richtige Server-URL für Ihren Kontotyp verwenden
3. Prüfen Sie, ob Ihre Integration in der 1Password Admin Console noch aktiv ist

### Fehlende Ereignistypen

Wenn die Integration eine Warnung anzeigt, dass eine Token-Funktion fehlt (Anmeldeversuche, Elementnutzung oder Audit-Ereignisse):

1. Öffnen Sie die 1Password Admin Console und bearbeiten Sie die Events-Reporting-Integration
2. Generieren Sie ein **neues** Token, bei dem der fehlende Ereignistyp unter **Events to Report** ausgewählt ist
3. Aktualisieren Sie das API-Token in Wirespeed

Das bisherige Token kann nicht um weitere Ereignistypen erweitert werden. Durch die Neugenerierung wird es ersetzt.

### Keine Ereignisse sichtbar

Wenn keine Ereignisse angezeigt werden:

1. Nach der Ersteinrichtung kann es einige Minuten dauern, bis Ereignisse erscheinen
2. Prüfen Sie, ob in Ihrem 1Password-Konto Aktivität stattfindet
3. Prüfen Sie, ob die Funktion Events Reporting in Ihrem 1Password-Konto aktiviert ist

### Ratenbegrenzung

Die 1Password Events API unterliegt Ratenbegrenzungen. Wenn eine Ratenbegrenzung auftritt:

1. Wirespeed wiederholt die Anfrage automatisch mit exponentiellem Backoff
2. Die Ereignisse werden beim nächsten Synchronisierungszyklus erfasst

## Weitere Ressourcen

* [Dokumentation der 1Password Events API](https://developer.1password.com/docs/events-api/)
* [Referenz der 1Password Events API](https://developer.1password.com/docs/events-api/reference/)
* [Events Reporting einrichten](https://developer.1password.com/docs/events-api/get-started/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.