LocalStack Extension for Authress Authentication and Authorization

This is the LocalStack extension that enables running authentication, user identity, permissions, api key management, and access control in your LocalStack environment via Authress.

This LocalStack extension generates a copy of the Authress API so that the authentication and access management the Authress API provides can be utilized by running services directly in any environment. You can use this to build authentication and authorization directly into your applications and services. Additionally, this extension can be used locally to develop faster without needing an Authress Account.

Installation

To install the Authentication & Authorization extension into LocalStack, run

localstack extensions install localstack-extension-authress

Usage

Start LocalStack if it isn't started already. You can do this by running:

ACTIVATE_PRO=1 LOCALSTACK_AUTH_TOKEN="LOCALSTACK_AUTH_TOKEN" EXTENSION_DEV_MODE=1 DEBUG=1 localstack start

If you run into any issues doing that, check out the Troubleshooting Guide.

The auth extension runs at http://authress.localhost.localstack.cloud:4566.

You can configure API calls to the authorization server by passing this url as the authressApiUrl or the authress_api_url depending on which SDK you are using.

import { AuthressClient } from 'authress-sdk';
const authressClient = new AuthressClient({ authressApiUrl: `http://authress.localhost.localstack.cloud:4566` });
await authressClient.userPermissions.authorizeUser(userId, resourceUri, permission);

Knowledge Base

Review the in depth guides in the Authress Local KB.

Contribution Guide

Developing for the LocalStack Authress Extension

Authorization as a service Security authorization authorization as a service authentication user authentication Authress Authress client access management access management as a service user security localstack localstack extensions verified verified access verified permissions open source policy engine embedded authorization batteries included authorization

Metadata

Release files for localstack-extension-authress 0.1.24

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for localstack-extension-authress 0.1.24
File	Size	Uploaded
localstack_extension_authress-0.1.24.tar.gz	17.2 kB	Jul 23, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for localstack-extension-authress 0.1.24
File	Interpreter	ABI	Platform	Reset
localstack_extension_authress-0.1.24-py3-none-any.whl 17.8 kB Jul 23, 2024	Python 3	none	any	Details

Total release size: 35.1 kB

Release files / localstack_extension_authress-0.1.24.tar.gz

Download URL	localstack_extension_authress-0.1.24.tar.gz
Size	17.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`b21143290b1259c311d7981603bb9dd1ab610d1da6b9d990a8b0bdf06d7a21f8`
BLAKE2b-256 checksum How to use checksums	`94cf1ee68949789e71b5b80bb607159f51ffc6911804946b6430f3db9f55fce1`
Upload date	Jul 23, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/5.1.0 CPython/3.12.4`

Release files / localstack_extension_authress-0.1.24-py3-none-any.whl

Download URL	localstack_extension_authress-0.1.24-py3-none-any.whl
Size	17.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ada4c23699dcab558639a0db4ee92870d9e7a56d68ba0616edad23c581c096c7`
BLAKE2b-256 checksum How to use checksums	`2abf42c4fca858492f754b630f2c0f573296469ee32780c01e1694a2828a4cde`
Upload date	Jul 23, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/5.1.0 CPython/3.12.4`