https://github.com/qnipp/meteor-saml-demo
SAML integration for Meteor
https://github.com/qnipp/meteor-saml-demo
meteor meteor-package saml
Last synced: 3 months ago
JSON representation
SAML integration for Meteor
- Host: GitHub
- URL: https://github.com/qnipp/meteor-saml-demo
- Owner: qnipp
- License: mit
- Created: 2024-05-01T13:44:46.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-01T19:33:20.000Z (about 1 year ago)
- Last Synced: 2025-02-20T21:35:53.688Z (4 months ago)
- Topics: meteor, meteor-package, saml
- Language: JavaScript
- Homepage: https://meteor-saml-demo.meteorapp.com/
- Size: 41 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# meteor-saml-demo
Demo for the [qnipp:accounts-saml](https://atmospherejs.com/qnipp/accounts-saml) package
See the [live demo on meteorapp.com](https://meteor-saml-demo.meteorapp.com/).
## Server configuration
* Set up the SAML providers as in [server/saml.js](./server/saml.js) or provide them in `Meteor.settings.saml`
* (Optional) Create hooks for validations and the account creation as in [server/accounts-hooks.js](./server/account-hooks.js)
## Client configuration
The demo client is based on React.
* The login is performed via a redirection. The respective links for all configured SAML providers are available through the `saml.getLoginLinks` method. See the example in [import/ui/LoginLinks.jsx](./import/ui/LoginLinks.jsx).
* A successful login can easily detected using the reactive `Meteor.user()` method. See the example in [import/ui/User.jsx](./import/ui/User.jsx).
* An unsuccesful login can be detected by registering a callback to `Accounts.onLoginFailure()`. See the example in [import/ui/LoginState.jsx](./import/ui/LoginState.jsx).
* If setting up the UI takes longer than the login, it might help to set `Meteor.settings.public.saml.performPendingLoginManually` to `true` and run `performPendingLogin` on a proper place.
See this example for the last point as part of the login form:
```js
const [loginState, setLoginState] = useState({ state: 'loggedout' });
useEffect(() => {
const onLoginFailure = Accounts.onLoginFailure((error) => {
if (loginState.state === 'loggedout') {
// to distinguish SAML logins from password logins
setLoginState({ state: 'failure', error });
}
});
performPendingLogin();
return onLoginFailure.stop;
}, []);
```
## Further reading
See the [README](./packages/meteor-accounts-saml/README.md) file of the package.