msal_browser

Crates.iomsal_browser
lib.rsmsal_browser
version0.2.7
sourcesrc
created_at2020-08-04 11:35:29.543729
updated_at2023-02-09 05:31:39.478219
descriptionRust WASM wrapper for msal-browser.js
homepage
repositoryhttps://github.com/pauldorehill/msal_browser_rust
max_upload_size
id272877
size2,595,856
Paul D (pauldorehill)

documentation

README

Rust + WASM + msal-browser

Rust wrapper for msal-browser.js.

Methods names all match the js but with snake case, but unlike the js instead of a single PublicClientApplication type there are two app types:

  • PopupApp
  • RedirectApp

The PopupApp is a the default feature: if you want to use the RedirectApp it is behind the redirect feature:

msal_browser = { version = "0.2.0", features = ["redirect"] }

There are a huge amount of Configuration options so the rust side uses a builder pattern. You can also use a js Object and call Configuration::unchecked_from.

To use:

const CLIENT_ID: &str = "CLIENT_ID";
const AUTHORITY: &str = "AUTHORITY";

// Setup App
let auth_options = BrowserAuthOptions::new(CLIENT_ID).set_authority(AUTHORITY);
let config = Configuration::new(auth_options);
let client_app = PopupApp::new(config);

// Define some scopes
let scopes = ["User.Read"];

// Login
let auth_res = client_app.login_popup().await.unwrap();
let auth_res = client_app.login_popup_with_scopes(&scopes).await.unwrap();

// Account Info
let account = client_app.get_account_by_username("username").unwrap();
let account = client_app.get_account_by_home_id("home_id").unwrap();
let accounts = &client_app.get_all_accounts();

// Requests
let auth_request = AuthorizationUrlRequest::new(&scopes[..]).set_login_hint(account.username());
let silent_request = SilentRequest::new(&scopes[..], &account);
let end_session_request = EndSessionRequest::new();

// SSO sign in
let sso_auth_result = client_app.sso_silent(&auth_request).await.unwrap();

// Popup token
let token = client_app.acquire_token_popup(&auth_request).await.unwrap();

// Silent token
let silent_token = client_app
    .acquire_token_silent(&silent_request)
    .await
    .unwrap();

// Logout
client_app.logout(None);

Example

There is an example app that uses the fantastic dominator dom library.

Tests

Curently there are tests that can be run using ./run_tests.sh or wasm-pack test --safari --headless -- --features "popup redirect

Notes

Needs node installed to build. Currently published to crates.io using --no-verify: this is because the build.rs requires all the node modules installed to run successfully and is modifying files outside of OUT_DIR for buildng the js. Since version 2.12 they switched to using preserveModules = true 3563 which means that the old index.es.js file doesn't exist and instead modules imports are left. So now I am using Rollup to generate the required file to link to in rust with bindgen.

Commit count: 34

cargo fmt