# macOS-Konfiguration

macOS-Apps empfangen Push-Benachrichtigungen über den Apple Push Notification Service (APNs), denselben Zustellkanal, den auch iOS verwendet. Konfigurieren Sie die macOS-Plattform in Pushwoosh entweder mit einer zertifikatbasierten (.p12) oder einer tokenbasierten (.p8) Verbindung zu APNs.

<Aside type="note">
Stellen Sie sicher, dass für Ihre macOS-App die Funktion „Push-Benachrichtigungen“ aktiviert und eine App-ID im Apple Developer Portal registriert ist, bevor Sie beginnen. Lesen Sie mehr in der [Apple-Entwicklerdokumentation](https://developer.apple.com/documentation/usernotifications/registering_your_app_with_apns).
</Aside>

## Zertifikatbasierte Konfiguration

### Erstellen des .p12-Zertifikats

Die Schritte für den Schlüsselbund, das Apple Developer Portal und den Export entsprechen dem iOS-Zertifikatsablauf. Folgen Sie dieser Anleitung und verwenden Sie Ihre **macOS**-App-ID, wenn Apple Sie auffordert, eine auszuwählen:

1. [Erstellen Sie eine Zertifikatsanforderungsdatei](/de/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/#generating-a-certificate-request-file) in der **Schlüsselbundverwaltung**.
2. [Erstellen Sie ein APNs-Zertifikat im Apple Developer Portal](/de/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/#creating-an-apns-certificate-in-apple-developer-portal). Wenn Sie eine **App-ID** auswählen, wählen Sie die ID für Ihre macOS-App, nicht die für iOS.
3. [Exportieren Sie den privaten Schlüssel als .p12](/de/developer/first-steps/connect-messaging-services/ios-configuration/ios-platform-configuration/#exporting-the-private-key-p12) aus der **Schlüsselbundverwaltung**.

Sie benötigen die .p12-Datei und das Passwort für den privaten Schlüssel im nächsten Abschnitt.

### Konfigurieren der macOS-Plattform in Pushwoosh

1. Gehen Sie in Ihrem Pushwoosh-Projekt zu **Settings → Configure Platforms**.
2. Klicken Sie neben **macOS** im Abschnitt **Desktop platforms** auf **Connect**.

<img src="/configure-project-macos-configuration-1.webp" alt="Abschnitt 'Desktop-Plattformen' mit der macOS-Zeile, dem Status 'Nicht konfiguriert' und der Schaltfläche 'Verbinden'"/>

3. Wählen Sie im **Configuration mode for macOS** die Option **Certificate-based manual configuration**.
4. Klicken Sie auf **Next**.

<img src="/configure-project-macos-configuration-2.webp" alt="Konfigurationsmodus für macOS mit ausgewählter zertifikatbasierter manueller Konfiguration"/>

5. Füllen Sie auf der Seite **Certificate-based configuration for macOS** das Formular aus:
   * **Certificate file (.p12):** Laden Sie die .p12-Datei hoch, die Sie aus der Schlüsselbundverwaltung exportiert haben.
   * **Private key password:** Geben Sie das Passwort ein, das Sie beim Exportieren der .p12-Datei festgelegt haben.
   * **Gateway:** Wählen Sie **Sandbox** für die Entwicklung oder **Production** für Live-Apps.

<img src="/configure-project-macos-configuration-3.webp" alt="Zertifikatbasierte Konfiguration für macOS mit p12-Upload, Passwort, Gateway und Konfigurieren"/>

6. Klicken Sie auf **Configure**, um die Einrichtung abzuschließen.

## Tokenbasierte Konfiguration

Sie können die macOS-Plattform mit tokenbasierter Authentifizierung für eine schnellere Kommunikation mit APNs konfigurieren.

<Aside type="note">
Weitere Informationen finden Sie in den [Apple Developer Docs](https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/establishing_a_token-based_connection_to_apns).
</Aside>

### Einen Signierschlüssel von Apple erhalten

Das Erstellen des APNs-Schlüssels ist dasselbe wie für iOS. Folgen Sie den Anweisungen unter [Einen Verschlüsselungsschlüssel und eine Schlüssel-ID von Apple erhalten](/de/developer/first-steps/connect-messaging-services/ios-configuration/ios-token-based-configuration/#obtain-an-encryption-key-and-key-id-from-apple) in der Anleitung zur tokenbasierten Konfiguration für iOS.

Sie benötigen die **Schlüssel-ID** und die **.p8**-Datei im nächsten Abschnitt. Sie können denselben APNs-Schlüssel wiederverwenden, den Sie bereits für iOS verwenden, falls Sie einen haben.

### Konfigurieren der macOS-Plattform in Pushwoosh

1. Gehen Sie in Ihrem Pushwoosh-Projekt zu **Settings → Configure Platforms**.
2. Klicken Sie neben **macOS** im Abschnitt **Desktop platforms** auf **Connect**.

<img src="/configure-project-macos-configuration-1.webp" alt="Abschnitt 'Desktop-Plattformen' mit der macOS-Zeile, dem Status 'Nicht konfiguriert' und der Schaltfläche 'Verbinden'"/>

3. Wählen Sie im **Configuration mode for macOS** die Option **Token-based configuration**.
4. Klicken Sie auf **Next**.

<img src="/configure-project-macos-configuration-4.webp" alt="Konfigurationsmodus für macOS mit ausgewählter tokenbasierter Konfiguration und der Schaltfläche 'Weiter'"/>

5. Füllen Sie auf der Seite **Token-based configuration for macOS** das Formular aus:
   * **Key ID:** Fügen Sie die 10-stellige Schlüssel-ID von Apple ein.
   * **Team ID:** Geben Sie Ihre Apple Developer Team ID aus dem Abschnitt **Membership** Ihres Apple Developer-Kontos ein.
   * **Bundle ID:** Geben Sie die Bundle-ID Ihrer macOS-App aus **Certificates, Identifiers & Profiles** ein.
   * **Auth Key (.p8):** Laden Sie die .p8-Signierschlüsseldatei hoch, die Sie von Apple heruntergeladen haben.
   * **Gateway:** Wählen Sie **Sandbox** für die Entwicklung oder **Production** für Live-Apps.

<img src="/configure-project-macos-configuration-5.webp" alt="Tokenbasierte Konfiguration für macOS mit Schlüssel-ID, Team-ID, Bundle-ID, Authentifizierungsschlüssel, Gateway"/>

6. Klicken Sie auf **Configure**, um die Einrichtung abzuschließen.

<Aside type="tip">
Um zu überprüfen, ob die macOS-Plattform erfolgreich konfiguriert wurde, senden Sie eine Test-Push-Benachrichtigung oder richten Sie eine Nachricht an ein bestimmtes Gerät. Richtlinien finden Sie auf der Seite [Testen Sie Ihre Integration](/de/developer/first-steps/test-your-integration).
</Aside>