Add your description here
Project description
streamlit-msal
Basic implementation of Microsoft Authentication Library (MSAL) for Streamlit
Disclaimer
This library is designed with simplicity and user-friendliness in mind, and as such, it may not encompass all possible functionalities. It primarily relies on pop-up windows for sign-in and revalidation of authentication processes.
While this approach provides a straightforward user experience, it may not be suitable for all use cases, especially those requiring more complex or robust authentication workflows. Please consider your specific requirements when deciding to use this library.
Installation
pip install streamlit-msal
Application Configuration (Azure)
Create an App with OpenID Connect (OIDC) based sign-on
Add a Single-page application platform and configure a redirect URI. http://localhost:8501 will work for Streamlit applications running locally.
Required information:
client_id = "<Application (client) ID>"
authority = "https://login.microsoftonline.com/<Directory (tenant) ID>"
UI Example (Easiest way)
This example uses "initialize_ui", that provides a UI with the core functionality in a simple but beautiful way.
import streamlit as st
from streamlit_msal import Msal
with st.sidebar:
auth_data = Msal.initialize_ui(
client_id=client_id,
authority=authority,
scopes=[], # Optional
# Customize (Default values):
connecting_label="Connecting",
disconnected_label="Disconnected",
sign_in_label="Sign in",
sign_out_label="Sign out"
)
if not auth_data:
st.write("Authenticate to access protected content")
st.stop()
st.write("Protected content available")
Headless example (Build your UI)
This example uses "initialize", that doesn't provide a UI so you can create your own.
from streamlit_msal import Msal
auth_data = Msal.initialize(
client_id=client_id,
authority=authority,
scopes=[],
)
if st.button("Sign in"):
Msal.sign_in() # Show popup to select account
if st.button("Sign out"):
Msal.sign_out() # Clears auth_data
if st.button("Revalidate"):
Msal.revalidate() # Usefull to refresh "accessToken"
Accessing result value
# Getting usefull information
access_token = auth_data["accessToken"]
account = auth_data["account"]
name = account["name"]
username = account["username"]
account_id = account["localAccountId"]
# Display information
st.write(f"Hello {name}!")
st.write(f"Your username is: {username}")
st.write(f"Your account id is: {account_id}")
st.write("Your access token is:")
st.code(access_token)
st.write("Auth data:")
st.json(auth_data)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file streamlit_msal-0.2.0.tar.gz
.
File metadata
- Download URL: streamlit_msal-0.2.0.tar.gz
- Upload date:
- Size: 795.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 06e96d3e4bac840003a557d9006c3055f5c45efd49d31d6e7371cfec3b6ef1b3 |
|
MD5 | 209dab424b525f111458c282b1cacdc0 |
|
BLAKE2b-256 | 2183dfabc48363be96a17dabaae9f80019567d52736ea1adeda6933c83d96462 |
File details
Details for the file streamlit_msal-0.2.0-py3-none-any.whl
.
File metadata
- Download URL: streamlit_msal-0.2.0-py3-none-any.whl
- Upload date:
- Size: 807.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 67ee6e754feec42f17a77a5177f5c8fe8da567e1dff9cf85d462e5e25f26e5cf |
|
MD5 | d2b2c23462b6252d23d225f1224fe3d8 |
|
BLAKE2b-256 | c2611eeb09b93e0b00512dc3d787ea3a4a5cd89b70fe5debeb066b6a86e8e0df |