Welcome to Streamlit RSA Authenticator UI 🔐

Encryption on Authenticate widget data from client to server.

What is Streamlit RSA Authenticator UI?

What is Http protocol

Http is the information transfer protocol between networked devices. However, all the requests and responses are in plaintext, which means that anyone can read them.

If you want to deploy streamlit server using http protocol (not https protocol) and you add the user authentication, user password can be read by anyone in the network as it is the plaintext for http protocol.

streamlit-rsa-auth-ui correct it by encrypting user information including password at the client browser before transmit to streamlit server using RSA algorithm

What is RSA algorithm

It is asymmetric cryptography, uses two different but mathematically linked keys

• Public key that can be share with everyone
• Private key must be kept secret

Installation

Open a terminal and run:

pip install streamlit-rsa-auth-ui

Quickstart

Gnerate RSA Key Pair

Create a new file generateKeys.py

from streamlit_rsa_auth_ui import Encryptor

encryptor = Encryptor.generateNew(2048)
encryptor.save('rsa', 'authkey')

Run generateKeys.py python script

python generateKeys.py

this will create a private key and public key pair

• private key with the file name authkey
• public key with the file name authkey.pub

├── rsa
│ ├── authkey
│ │ authkey.pub

Create streamlit page

Create a new file example.py

import streamlit as st
from streamlit_rsa_auth_ui import Encryptor, authUI, SigninEvent, SigninFormConfig, getEvent
ss = st.session_state

encryptor = Encryptor.load('rsa', 'authkey')
ui = authUI('login_ui_result', encryptor.publicKeyPem)

def checkAuth(username: str, password: str):
    return username == 'test' and password == 'New.Prog'

def login():
    if 'event' in ss and type(ss.event) is SigninEvent: return True
    result = ui.signinForm(default={'remember': True}, configs=SigninFormConfig(remember="Rememeber Me"))
    if result is None: return None

    _dict = encryptor.decrypt(result)
    event = getEvent(_dict)
    if type(event) is not SigninEvent or not checkAuth(event.username, event.password): return False
    ss['event'] = event
    st.rerun()

def logout():
    result = ui.signoutForm()
    if result is None: return False
    _dict = encryptor.decrypt(result)
    event = getEvent(_dict)
    ss['event'] = event
    return True

if not login(): st.stop()
with st.sidebar:
    if logout(): st.rerun()

st.title('Streamlit Rsa Auth UI Test')
button = st.button('test')
button

Run the streamlit app

streamlit run example.py

Change Log

Version 0.0.1

• Initial release

Version 0.0.2

• Fix missing frontend issue

Version 0.0.3

• Optional 'cancel' button to signoutform
• Minor bug fixed
• Remove bootstrap.min.css warning

Version 0.0.4

• Remove location setting(seem redundunt as if you want to add to any container/sidebar you can call with syntax)
• Add in classname to frontend so that easier to add in custom styling if needed
• Remove off the unnecessary excess height of streamlit

Version 1.0.0

• More customizable UI
• Add inline mode
• Add ChangePassword UI

Version 1.1.0

• Add id property in event if no public key is provided
• Add AuthUI class
• Add Configs class

Version 1.1.1

• Fix 'no remember in signinevent' when remember option is disabled