4players/odin-tokens

A lightweight token generator for 4Players ODIN

Maintainers

Details

github.com/4Players/odin-tokens-php

Homepage

Source

Issues

Installs: 5

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 0

Open Issues: 0

v1.2.0 2023-06-07 10:54 UTC

Requires

ISC a74ef181e9acc58283a6c2fad773e3608b59b862

  • Sven Paulsen <sven.woop@4players.io>

AuthenticationjwtEd25519

This package is auto-updated.

Last update: 2025-03-07 15:23:00 UTC

README

This is a lightweight package to generate API keys and tokens used by 4Players ODIN.

4Players ODIN is a cross-platform software development kit (SDK) that enables developers to integrate voice and video chat technology into multiplayer games, apps and websites.

Online Documentation

Flowchart

graph TB
  RandomBytes[Random Bytes] --> AccessKey;
  AccessKey --> PublicKey;
  AccessKey --> SecretKey;
  PublicKey --> KeyId;
Loading

Example

use FourPlayers\Odin\TokenGenerator;

$accessKey = "<YOUR ACCESS KEY HERE>";
$generator = new TokenGenerator($accessKey);
$token = $generator->createToken("my room", "john doe");

echo "generated a new token: $token\n"

Terminology

Term Description
AccessKey Gives access to the ODIN network for a customer. It is a 44 character long Base64-String, which consists of a version, random bytes and a checksum.
SecretKey Generated from the AccessKey, it is based on the Ed25519-Curve and used to sign a Token generated by the customer.
PublicKey Generated from the AccessKey, it is based on the Ed25519-Curve and must be uploaded to 4Players so that a generated Token can be verified.
KeyId A shortened PublicKey, included in Token, making it possible to identify what PublicKey must be used to verify the Token.
Token A JWT given to the game clients that allows them to connect to a voice/video chat room in the ODIN network.