.. _extern instellen:

Externe Client
==============

Naast de "Polka interne OAuth Client", is het ook mogelijk om een eigen OAuth client te gebruiken en de access_token aan Polka te geven.


instellen MapsAPI/POLKA OAuth & Externe OAuth Client
----------------------------------------------------

- Je hebt een MapsAPI Applicatie aangemaakt

- Ga naar applicatie instellingen

  .. image:: images/planviewer-applicatie-instellingen.png

- In MapsAPI: Bewerk OAuth gegevens

  .. image:: images/bewerk-oauth-gegevens.png

- In MapsAPI OAuth: Kies "Extern" en klik op "Opslaan"

  .. image:: images/kies-extern.png


- In MapsAPI OAuth: Vul veld "Issuer" in
  Deze moet overeenkomen met de claim "iss" van de door externe server uitgegeven JWT

- In MapsAPI OAuth: Vul veld "JWKS URI" in
  Deze moet wijzen naar de locatie van de externe server waar de "JSON Web Key Sets" op te halen is.
  voorbeeld: `https://example.com/.well-known/jwks.json`

- In MapsAPI OAuth: Klik op "Opslaan"
  Na opslaan is het veld "Audience" ingevuld, dit is de waarde die door de externe server gebruikt moet worden als claim "aud" in de JWT.


- Configureer Polka:

  provider: "extern" en stel een callback in die een access_token ophaalt en teruggeeft.

.. literalinclude:: config/polka-oauth-extern.json
   :language: json

.. literalinclude:: example/extern.js
   :language: javascript
   :lines: 82-89

    volledig voorbeeld: :ref:`full-example`
    


De POLKA viewers in jouw MapsAPI applicatie maken nu gebruik van een externe OAuth provider

.. _full-example:

Volledige voorbeeld
-------------------

index.html

.. literalinclude:: example/index.html
   :language: html

setup.js

.. literalinclude:: example/setup.js
   :language: javascript