tilegroxy Docs

Description

Requests that do not comply with authentication requirements will receive a 401 Unauthorized HTTP status code.

When supplying authentication ensure you include the name parameter.

Choosing an authentication

Goal Authentication Notes

Allow every request

None

Only safe behind an external authentication layer

Block casual scrapers on a dev or intranet deployment

Static Key

One shared bearer token. Not true security

Accept tokens issued by an identity provider

JWT

Verifies the signature locally with a static key or a JWKS endpoint. Can limit layers and areas per token

Validate API keys you already store in a database

Bearer Lookup

Looks the token up in PostgreSQL or Redis. Can set user and tenant IDs

Reuse an existing login or API in your ecosystem

Passthrough

Forwards credentials to an HTTP endpoint. Can set user and tenant IDs from the response

Anything else

Custom

Your own Go code interpreted with Yaegi. See Extensibility

Comparison

Authentication User ID Tenant ID Limit by layer/area External dependency

None

No

No

No

No

Static Key

No

No

No

No

JWT

Yes

Yes

Yes

JWKS endpoint, optional

Bearer Lookup

Yes

Yes

No

PostgreSQL or Redis

Passthrough

Yes

Yes

No

HTTP endpoint

Custom

Yes

Yes

Yes

Up to your code