Package: ez0th
ez0th - Python Library for Easy Authentication and Authorization下の方に日本語の説明がありますOverviewez0this a Python library designed to simplify the process of implementing authentication and authorization in your applications. The library follows the Dependency Inversion Principle, making it highly flexible and adaptable to various web frameworks such as Django, Flask, and FastAPI, as well as different types of databases.FeaturesSimplifies the implementation of authentication and authorization functions such as login.Designed following the Dependency Inversion Principle.Supports various backends including any type of database by providing a suitable connection function. By default, it uses the json-stock database.Allows the use of multiple user IDs and provides efficient user lookup.Securely stores passwords using hashing techniques, protecting them even in case of a database breach.Generates hard-to-guess internal IDs and salts using cryptographically secure random numbers.The library name ez0th is pronounced as "easy auth".Usage Example# Authentication & Authorization Tool [ez0th]# [Usage Example / Test]importez0th# Default ez0th database [ez0th]db=ez0th.json_stock("./__ez0th_user_db__/")# Account registration [ez0th]success_flag=ez0th.new_account(id_dic={"user_id":"WhiteDog","mail":"example@example.com"},# ID list (dictionary of all identifiers that can be used as login IDs, such as email addresses)password="abc123",# Passwordinfo={},# Other account informationdb=db,# Database)# Result checkprint(success_flag)# Authentication (Login) [ez0th]success_flag,sess_token=ez0th.login(u_id="WhiteDog",# Login ID (any registered ID is acceptable)password="abc123",# Passworddb=db,# Databasetimeout=24*10# Timeout duration (in hours; specify inf for infinite duration))# Result checkprint(success_flag)print(sess_token)# Authorization (Login confirmation) [ez0th]success_flag,info=ez0th.auth(sess_token=sess_token,# Session tokendb=db# Database)# Result checkprint(success_flag)print(info)# Contact verification functiondefsend_func(sess_token):print(f"Mail sending function (dummy implementation)\n\nThis is a confirmation email. Please access the link below to perform (account registration, password changes, etc.)\nhttps://example.com/mail_auth/{sess_token}")# Contact existence verification function (email confirmation, etc.) [ez0th]sent_flag=ez0th.confirm_mail(u_id="WhiteDog",# Login id (Any intended registered id is acceptable)send_func=send_func,# Mail sending function etc. (argument: sess_token (for creating confirmation URL))db=db,# Databasetimeout=1# Timeout period (in hours; infinite if specified as inf))# Result confirmationprint(sent_flag)# Account existence verification [ez0th]flag=ez0th.exists(u_id="WhiteDog",# Login id (any registered id is acceptable)db=db,# Database)# Check the resultprint(flag)# Password change [ez0th]success_flag=ez0th.change_pw(sess_token=sess_token,# Session tokenpassword="abc123456",# New passworddb=db,# Database)# Check resultprint(success_flag)# Prepare updated user informationsuccess_flag,info=ez0th.auth(sess_token,db)# Authorization (login verification) [ez0th]old_user_info=info["account_info"]["info"]new_user_info={**old_user_info,"Role":"Technical Leader"}# Update user information [ez0th]success_flag=ez0th.update_user_info(sess_token=sess_token,# Session tokennew_user_info=new_user_info,# Updated user informationdb=db,# Database)# Check resultprint(success_flag)# Get user information (Be cautious as there is no authentication process, which may result in information leakage) [ez0th]info=ez0th.get_info(u_id="WhiteDog",# Login ID or inner_id (Any registered ID can be used)db=db,# Database)# Check the resultprint(info)# Logout [ez0th]success_flag=ez0th.logout(sess_token=sess_token,# Session tokendb=db# Database)# Check resultprint(success_flag)# Check the databaseimportjson_stockasjstprint("db_state:")print(jst.JsonStock("__ez0th_user_db__"))Creating Custom Connection FunctionsTo write a custom connection function, you need to store a dictionary with the keys create, read, update, delete, and contains in the db variable. For the values, you should store functions that have been processed to act as a key-value type database using strings as keys and values. For example, the create function would be used like this:create(key, value). The input and output for the other functions are as follows:value = read(key)update(key, value)delete(key)flag = contains(key)Even when using a database like SQL as the backend, you will need to adapt and transform the interface to match the above format to work as a key-value type.Note that when using the default ez0th.db(), the return value also takes the form described above.PrecautionsWhile this library provides basic authentication and authorization features, developers themselves need to take appropriate measures to ensure the overall security of their applications. For example, consider implementing HTTPS for secure communication and measures against XSS attacks.Although password protection uses hashing technology, it does not guarantee sufficient security. Consider implementing regular password changes and strong password policies.ez0th - 認証・認可を簡単に実装するPythonライブラリ概要ez0thは、認証・認可機能を簡単に実装するためのPythonライブラリです。「依存性逆転の原則」に従って設計されているため、DjangoやFlask、FastAPIなどのWebフレームワークや様々なデータベースに柔軟に対応できます。特徴ログインなどの認証・認可機能を簡単に記述できます。複数のユーザーIDを使用可能です。パスワードはハッシュ技術を用いて暗号化され、安全に保管されます。データベースが流出しても、パスワードはある程度守られます。内部IDやソルトの生成には、推測が困難な「暗号学的乱数」を使用しています。ライブラリ名の「ez0th」は、「イージー・オース(easy auth)」と読みます。「依存性逆転の原則」に従って設計されています。そのため、適切な接続関数を用意することで、様々なデータベースをバックエンドとして利用できます。デフォルトでは、「json-stock」データベースを使用します。使い方例# 認証・認可ツール [ez0th]# 【動作確認 / 使用例】importez0th# ez0thのデフォルトDB [ez0th]db=ez0th.json_stock("./__ez0th_user_db__/")# アカウント登録 [ez0th]success_flag=ez0th.new_account(id_dic={"user_id":"WhiteDog","mail":"example@example.com"},# id一覧 (メールアドレス等、ログイン時にidとして用いることのできるすべての識別子の辞書)password="abc123",# パスワードinfo={},# その他のアカウント情報db=db,# データベース)# 結果確認print(success_flag)# 認証 (ログイン) [ez0th]success_flag,sess_token=ez0th.login(u_id="WhiteDog",# ログインid (登録されたいずれのidも可)password="abc123",# パスワードdb=db,# データベースtimeout=24*10# タイムアウト時間 (時間単位; inf指定で無限大))# 結果確認print(success_flag)print(sess_token)# 認可 (ログイン確認) [ez0th]success_flag,info=ez0th.auth(sess_token=sess_token,# セッショントークンdb=db# データベース)# 結果確認print(success_flag)print(info)# 連絡先確認関数defsend_func(sess_token):print(f"メール送信機能 (ダミー実装)\n\n確認メールです。下記リンクにアクセスして(アカウント登録, パスワード変更 など)を行ってください\nhttps://example.com/mail_auth/{sess_token}")# 連絡先実在確認機能 (メール確認等) [ez0th]sent_flag=ez0th.confirm_mail(u_id="WhiteDog",# ログインid (登録されたいずれのidも可)send_func=send_func,# メール送信等の関数 (引数: sess_token (確認URL作成用))db=db,# データベースtimeout=1# タイムアウト時間 (時間単位; inf指定で無限大))# 結果確認print(sent_flag)# アカウント存在確認 [ez0th]flag=ez0th.exists(u_id="WhiteDog",# ログインid (登録されたいずれのidも可)db=db,# データベース)# 結果確認print(flag)# パスワード変更 [ez0th]success_flag=ez0th.change_pw(sess_token=sess_token,# セッショントークンpassword="abc123456",# 変更後のパスワードdb=db,# データベース)# 結果確認print(success_flag)# 変更後ユーザー情報の準備success_flag,info=ez0th.auth(sess_token,db)# 認可 (ログイン確認) [ez0th]old_user_info=info["account_info"]["info"]new_user_info={**old_user_info,"役職":"技術リーダー"}# ユーザー情報更新 [ez0th]success_flag=ez0th.update_user_info(sess_token=sess_token,# セッショントークンnew_user_info=new_user_info,# 変更後のユーザー情報db=db,# データベース)# 結果確認print(success_flag)# ユーザー情報取得 (認可処理は入っていないので、情報漏洩に注意) [ez0th]info=ez0th.get_info(u_id="WhiteDog",# ログインidまたはinner_id (登録されたいずれのidも可)db=db,# データベース)# 結果確認print(info)# ログアウト [ez0th]success_flag=ez0th.logout(sess_token=sess_token,# セッショントークンdb=db# データベース)# 結果確認print(success_flag)# db確認importjson_stockasjstprint("db_state:")print(jst.JsonStock("__ez0th_user_db__"))カスタム接続関数の作成方法カスタム接続関数を書くには、db変数に、create、read、update、delete、containsの5つのキーを持つ辞書を入れます。値としては、文字列をキーと値としてキー・値型のデータベースとして挙動するようなインターフェースに加工された関数を入れます。例えば、createは、create(key, value)のように使用します。その他の関数の入出力は以下の通りです。value = read(key)update(key, value)delete(key)flag = contains(key)SQLのようなデータベースをバックエンドとする際も、キー・値型になるようにインターフェースを工夫・変形して上記の形に合わせる必要があります。なお、デフォルトのez0th.db()を使用した場合でも、返り値は上記の形をしています。注意点このライブラリは、認証・認可の基本的な機能を提供しますが、アプリケーション全体のセキュリティに関しては、開発者自身が適切な対策を講じる必要があります。例えば、セキュアな通信を行うためのHTTPSの導入や、XSS対策なども検討してください。パスワードの保護は、ハッシュ技術を用いていますが、それでも十分なセキュリティが保証されるわけではありません。定期的なパスワード変更や、強力なパスワードポリシーの導入を検討してください。