Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/casdoor/casdoor-rust-sdk
Rust client SDK for Casdoor, see example at: https://github.com/casdoor/casdoor-rust-example
https://github.com/casdoor/casdoor-rust-sdk
auth authentication authn casdoor iam jwt oauth oidc rust sdk sso
Last synced: about 16 hours ago
JSON representation
Rust client SDK for Casdoor, see example at: https://github.com/casdoor/casdoor-rust-example
- Host: GitHub
- URL: https://github.com/casdoor/casdoor-rust-sdk
- Owner: casdoor
- License: apache-2.0
- Created: 2022-05-20T11:13:25.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-09-27T08:47:48.000Z (about 1 year ago)
- Last Synced: 2024-11-14T00:52:18.301Z (about 21 hours ago)
- Topics: auth, authentication, authn, casdoor, iam, jwt, oauth, oidc, rust, sdk, sso
- Language: Rust
- Homepage: https://github.com/casdoor/casdoor
- Size: 51.8 KB
- Stars: 9
- Watchers: 3
- Forks: 7
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# casdoor-rust-sdk
[](https://github.com/casdoor/casdoor-rust-sdk/commits/master)
[](https://crates.io/crates/casdoor-rust-sdk)
[](https://docs.rs/casdoor-rust-sdk)
[](https://github.com/casdoor/casdoor-rust-sdk/actions)
[](https://discord.gg/5rPsrAzK7S)
This is Casdoor's SDK for Rust, which will allow you to easily connect your application to the Casdoor authentication system without having to implement it from scratch.
Casdoor SDK is very simple to use. We will show you the steps below.
```toml
[dependencies]
casdoor-rust-sdk =
```
## Step1. Init SDK
Initialization requires 6 parameters, which are all string type:
| Name (in order) | Must | Description |
| --------------- | ---- | --------------------------------------------------- |
| endpoint | Yes | Casdoor Server Url, such as `http://localhost:8000` |
| client_id | Yes | Client ID for the Casdoor application |
| client_secret | Yes | Client secret for the Casdoor application |
| certificate | Yes | x509 certificate content of Application.cert |
| org_name | Yes | The name for the Casdoor organization |
| app_name | No | The name for the Casdoor application |
```rust
// init from params.
let app = CasdoorConfig::new(endpoint, client_id, client_secret, certificate, org_name);
// init from toml file, file_path should be absolute path. (recommend)
let conf = CasdoorConfig::from_toml(file_path).unwrap().as_str()).unwrap();
```
## Step2. Get service and use
Now provide two services: `CasdoorUserService`, `CasdoorAuthService`
You can create them like:
```rust
let user_service = UserService::new(&conf);
let auth_src = AuthService::new(&conf);
```
## Step3. Interact with the sdk services
The SDK support basic operations.
**user**
- `get_user(name)`, get one user by user name.
- `get_users()`, get all users.
- `get_sorted_users(sorter, limit)`, get sorted user and limit number of result.
- `get_user_count(is_online)`, get user count.
- `add_user(User)`, write user to database.
- `update_user(User)`, update user info
- `delete_user(User)`, delete user
**auth**
- `get_auth_token(code)`, get the auth token.
- `parse_jwt_token(token)`, parse jwt token.