Table of Contents

MegaTracker Cloud-Service-Authentifizierung

Dieser Artikel beschreibt, wie die Authentifizierung für MegaTracker bei der Nutzung von Cloud-Services festgelegt wird.

Bevor Sie beginnen

Authentifizierung mit API Key und API Secret

Diese Methode eignet sich für die traditionelle Schlüsselpaar-Validierung. Sie müssen APIKeyAccessData verwenden, um das access-Objekt in MegaTrackerConfigs zu konstruieren.

const apiKeyAccess = new mega.APIKeyAccessData(
    settings.MegaTrackerAppID, // Mega-Lokalisierungsdienst-AppID
    settings.MegaTrackerServerAddress, // Mega-Lokalisierungsdienst-Adresse
    settings.EasyARAPIKey, // APIKey-String
    settings.EasyARAPISecret // APISecret-String
);
const megaTrackerConfigs: easyar.MegaTrackerConfigs = {
    access: apiKeyAccess
};
const sessionConfigs: easyar.SessionConfigs = {
    megaTrackerConfigs: megaTrackerConfigs,
    licenseKey: settings.EasyARLicenseKey
};
session = megaComponent.createSession(sessionConfigs);

In diesem Beispiel wird zunächst APIKeyAccessData mit der konfigurierten Cloud-Lokalisierungsbibliothek appId, Cloud-Service serverAddress, Cloud-Service apiKey und apiSecret erstellt.

Anschließend wird das erstellte APIKeyAccessData verwendet, um MegaTrackerConfigs zu erstellen. Dies bedeutet, dass die Authentifizierung mit API Key und API Secret verwendet wird.

Authentifizierung mit API Token

Wenn der Server APIToken regelmäßig (alle paar Minuten oder Stunden) aktualisieren und verteilen kann, bietet diese Methode höhere Sicherheit, da sie die direkte Verwendung von APISecret zur Signierung von Lokalisierungsanfragen vermeidet. Die Aktualisierungsmethode für APIToken finden Sie unter Erstellung und Verwendung von Token.

Sie können basierend auf der Gültigkeitsdauer des Tokens einen Timer im Frontend für Aktualisierungen einrichten.

Erstellen Sie zunächst mit der Mega-Lokalisierungsbibliothek-AppID und der Lokalisierungsdienst-Adresse aus den Einstellungen TokenAccessData.

Verwenden Sie dann das erstellte TokenAccessData zur Erstellung von MegaTrackerConfigs.

Erstellen Sie anschließend mit MegaTrackerConfigs und dem konfigurierten licenseKey die SessionConfigs.

Erstellen Sie schließlich mit der Methode createSession(sessionConfigs) der in der xr-frame-Szene angehängten EasyARMegaComponent eine Session.

Wenn das Token abläuft, muss updateToken(apiToken) zur Aktualisierung aufgerufen werden, andernfalls ist der Mega-Service nicht verfügbar und der Status im Lokalisierungsergebnis bleibt stets ApiTokenExpired.

const tokenAccess = new mega.TokenAccessData(
    settings.MegaTrackerAppID, // Mega-Lokalisierungsdienst-AppID
    settings.MegaTrackerServerAddress, // Mega-Lokalisierungsdienst-Adresse
    "your_api_token" // APIToken-String
);
const megaTrackerConfigs: easyar.MegaTrackerConfigs = {
    access: tokenAccess
};
const sessionConfigs: easyar.SessionConfigs = {
    megaTrackerConfigs: megaTrackerConfigs,
    licenseKey: settings.EasyARLicenseKey
};
session = megaComponent.createSession(sessionConfigs);

Dieses Beispiel zeigt, wie TokenAccessData verwendet wird, um MegaTrackerConfigs zu erstellen, und mit diesem MegaTrackerConfigs eine Session zur Verwendung der APIToken-Authentifizierung erstellt wird.