Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Der Authorization-Header und Proxys

Warum gültige Zugangsdaten trotzdem mit 401 antworten können - wie die REST-Schicht und expservices den Authorization-Header lesen, Server und Proxys, die ihn verwerfen (Apache mit PHP-FPM), die Servereinstellungen, die…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/mobile-app-developers/auth/authorization-header-and-proxies.md

On this page

This page is a translation. Read the English original

Der Authorization-Header und Proxys

Diese Seite richtet sich an App-Entwickler, die mit Zugangsdaten, die anderswo funktionieren, 401 erhalten, und an die Hosting-Verantwortlichen, mit denen sie sprechen werden. Die übliche Ursache sind nicht die Zugangsdaten, sondern der Weg, den der Header bis zu PHP nimmt.

Inhalt

  1. Wie der Server den Header liest
  2. Wer ihn verwirft
  3. Die Lösungen auf dem Server
  4. Die Lösung im Client für expservices
  5. Die Fälle unterscheiden

Wie der Server den Header liest

Die REST-Schicht liest Authorization aus den rohen Apache-Request-Headern, ohne Beachtung der Groß- und Kleinschreibung, und greift ersatzweise auf $_SERVER['HTTP_AUTHORIZATION'] zurück (ezpOauthUtility::getAuthorizationHeader()). Sie akzeptiert OAuth <token> und Bearer <token>; ein persönlicher API-Schlüssel wird an seinem Präfix expk_ erkannt. Die Remote-Dienste lesen HTTP_AUTHORIZATION oder REDIRECT_HTTP_AUTHORIZATION für Bearer <token> und zusätzlich den Header X-Exp-Token (expServiceBase).

Wer ihn verwirft

PHP stellt Skripten den Header Authorization nicht in jeder Konfiguration bereit. Die Quellen nennen den häufigen Fall: Apache mit PHP-FPM über mod_proxy_fcgi reicht ihn ohne Konfiguration nicht durch, und „on the reference installation Authorization does not arrive and X-Exp-Token is the header that works“ gilt für expservices (expservices-Referenz). Auch ein Proxy, ein Load Balancer oder ein CDN vor dem Server kann ihn entfernen. Das Symptom: 401 nur auf einem Server oder nur hinter dem Produktions-Proxy (Persönliche API-Schlüssel: Fehlerbehebung).

Die Lösungen auf dem Server

Laut den Quellen für Apache mit PHP-FPM eine der beiden Varianten:

CGIPassAuth On
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

Einen Proxy oder ein CDN konfigurieren Sie so, dass Authorization an den Ursprungsserver weitergeleitet wird und Antworten auf Anfragen mit diesem Header nicht zwischengespeichert werden. Das sind Aufgaben des Hostings; zeigen Sie den Personen, die den Server betreiben, diese Seite und die Tabelle zur Fehlerbehebung der Anleitung.

Die Lösung im Client für expservices

Senden Sie das Token zweimal, so wie es die mitgelieferten Clients tun:

Authorization: Bearer expt_...
X-Exp-Token: expt_...

Die REST-API hat keinen solchen zweiten Header; bei ihr muss Authorization ankommen (ein OAuth-Token, aber kein API-Schlüssel, kann auch als Parameter oauth_token eines POST-Formulars kommen; im Query-String nur, wenn die Website rest.ini [OAuthSettings] AllowTokenInQuery einschaltet, was dieser Abschnitt nicht empfiehlt, weil URLs protokolliert werden).

Die Fälle unterscheiden

AntwortWahrscheinliche Ursache
401, leerer Inhalt, WWW-Authenticate: OAuth realm='Exponential REST'keine Zugangsdaten haben PHP erreicht: Der Header wurde verworfen oder nicht gesendet
401 {"error":"invalid_token"}die Zugangsdaten kamen an und wurden abgelehnt: falsch, widerrufen oder ein Schlüssel in der URL
401 {"error":"expired_token"}der Schlüssel kam an und ist über sein Ablaufdatum hinaus
funktioniert mit curl auf dem Server, scheitert vom Telefon ausein Proxy oder CDN dazwischen

Vergleichen Sie eine Anfrage, die auf dem Server selbst gestellt wird, mit einer über die öffentliche Adresse; wenn nur die zweite scheitert, geht der Header unterwegs verloren.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x