====== Amazon Refresh-Token erzeugen ======

Um auf die Alexa API zugreifen zu können, musst Du einmalig einen Refresh-Token erzeugen. Mit diesem Token kann sich das Plugin gegenüber Amazon authentifizieren. Dieser Schritt ist normalerweise nur einmal erforderlich. Zur Erzeugung des Token benötigst Du ein Hilfsprogramm. Dieses lädst Du Dir unter folgendem Link herunter und startest es mit einem Doppelklick auf Deinem Desktop-Computer:

[[https://github.com/adn77/alexa-cookie-cli/releases/latest]]

Du musst die für Dein Betriebssystem passende Datei herunterladen (Windows, Linux, MacOS), für Windows z.B. ''alexa-cookie-cli-win-x64.exe''.  Nachdem Du das Programm mit einem Doppelklick gestartet hast, öffnet sich ein Kommandozeilenfenster (eventuell blockiert Windows das Ausführen - gehe wie immer in diesem Fall auf "Weitere Informationen" und dann auf "Trotzdem ausführen". Eventuelle Blockierungsanfragen der Firewall bestätigst Du.):

{{plugins:alexa2lox:pasted:20231029-094429.png?400}}

Nun öffnest Du Deinen Browser und gibst folgende URL ein: **''[[http://127.0.0.1:8080]]''**

Es öffnet sich die Amazon-Login-Seite. Hier gibst Du die Daten Deines Amazon-Accounts ein (eventuell musst Du anschließend auch noch ein OTP der 2-Faktor-Authentifierung eingeben).

{{plugins:alexa2lox:pasted:20240124-175641.png?400}}

Nachdem ihr Euch erfolgreich angemeldet habt, könnt ihr das Browserfenster wieder schließen. Der Token wird Euch im Kommandozeilenfenster angezeigt. Er beginnt mit ''Atnr|.....'' Wenn es nicht geklappt hat, versucht es einfach noch einmal. Nun markiert ihr den Token im Fenster und kopiert ihn mit Klick auf die rechte Maustaste in die Zwischenablage.

{{plugins:alexa2lox:pasted:20231029-100804.png?400}}

Der Token wird nun auf der Konfigurationsseite des Plugins eingefügt und abgespeichert. Nach dem Abspeichern solltet ihr im Logfile eine ähnliche Ausgabe wie folgende sehen und eure Geräte sollten Euch im Plugin angezeigt werden.

{{plugins:alexa2lox:pasted:20231029-101431.png?400}}

===== Hinweise: =====

Standardmäßig verwendet das Hilfsprogramm die deutsche Amazon-Webseite (amazon.de). Sollte das bei dir zu Problemen führen, kann man der Software verschiedene Optionen mitgeben, u. a. die Verwendung einer alternativen Amazon-Webseite. Sämtliche Parameter findest Du auf der Homepage des Hilfsprogramms: [[https://github.com/adn77/alexa-cookie-cli/]]

<code ->
Usage: cli [options]

Options:
  -q, --quiet                                     Non-interactive, output refresh_token on StdOut and exit
  -l, --logger <log target>                       Where to log to
  -p, --amazonPage <page>                         optional: possible to use with different countries, default is "amazon.de"
  -b, --baseAmazonPage <amazon.com|amazon.co.jp>  optional: Change the Proxy Amazon Page - all "western countries" directly use amazon.com! Change to amazon.co.jp for Japan
  -a, --amazonPageProxyLanguage <lang>            optional: language to be used for the Amazon Sign-in page the proxy calls. default is "de_DE"
  -L, --acceptLanguage <lang>                     optional: webpage language, should match to amazon-Page, default is "de-DE"
  -u, --userAgent <Browser>                       optional: own userAgent to use for all request, overwrites default one, should not be needed
  -H, --proxyOwnIp <hostname>                     provide own IP or hostname to later access the proxy. needed to setup all rewriting and proxy stuff internally (default: "localhost")
  -P, --proxyPort <port>                          optional: use this port for the proxy, default is 8080 (default: 8080)
  -B, --proxyListenBind <IP>                      optional: set this to bind the proxy to a special IP, default is "0.0.0.0"
  -V, --proxyLogLevel <error|warn|info|debug>     optional: Loglevel of Proxy, default "warn"
  -h, --help                                      display help for command
</code>