It is easy to read a specification and conclude the problem is solved. It is harder to sit with the twenty implementations that each read the same paragraph differently and still call themselves compliant.
This piece walks through how we think about it at Paycux, what we have changed our minds about, and where the sharp edges are.
A practical SCIM example: Provisioning new users in GitHub
That brings us to a practical scim example: provisioning new users in github. Normalization is the whole job. Two providers can be perfectly compliant and still disagree about what a group membership is, whether a logout is meaningful, and which attribute carries the email address.
Normalization is the whole job. Two providers can be perfectly compliant and still disagree about what a group membership is, whether a logout is meaningful, and which attribute carries the email address.
Provisioning: Creating a new user in your application automatically
Provisioning: Creating a new user in your application automatically deserves its own treatment. Normalization is the whole job. Two providers can be perfectly compliant and still disagree about what a group membership is, whether a logout is meaningful, and which attribute carries the email address.
Version the assumption, not just the code. Write down what you expect from the peer, and make the failure loud when it stops being true, because the alternative is a connection that half works for six weeks.
- Validate signature, issuer, audience and expiry as four separate checks
- Normalize provider attributes into one internal shape
- Fail loudly when a peer stops meeting a documented assumption
- Keep a fixture per provider so regressions surface in CI
Modification: Updating the user to add them to the correct team
Modification: Updating the user to add them to the correct team is where this gets concrete. Treat anything the other side sends as untrusted input until it has been through validation you wrote. Signature checks, issuer checks, audience checks and expiry checks are four separate decisions, and skipping any one of them is a real vulnerability rather than a theoretical one.
Treat anything the other side sends as untrusted input until it has been through validation you wrote. Signature checks, issuer checks, audience checks and expiry checks are four separate decisions, and skipping any one of them is a real vulnerability rather than a theoretical one.
Synchronization: Checking for out-of-band changes
That brings us to synchronization: checking for out-of-band changes. Treat anything the other side sends as untrusted input until it has been through validation you wrote. Signature checks, issuer checks, audience checks and expiry checks are four separate decisions, and skipping any one of them is a real vulnerability rather than a theoretical one.
Normalization is the whole job. Two providers can be perfectly compliant and still disagree about what a group membership is, whether a logout is meaningful, and which attribute carries the email address.
Treat anything the other side sends as untrusted input until it has been through validation you wrote.
Deprovisioning: Removing a user when they leave the company
Deprovisioning: Removing a user when they leave the company deserves its own treatment. Version the assumption, not just the code. Write down what you expect from the peer, and make the failure loud when it stops being true, because the alternative is a connection that half works for six weeks.
Version the assumption, not just the code. Write down what you expect from the peer, and make the failure loud when it stops being true, because the alternative is a connection that half works for six weeks.
Further Reading:
That brings us to further reading:. Version the assumption, not just the code. Write down what you expect from the peer, and make the failure loud when it stops being true, because the alternative is a connection that half works for six weeks.
Normalization is the whole job. Two providers can be perfectly compliant and still disagree about what a group membership is, whether a logout is meaningful, and which attribute carries the email address.
The developer’s guide to Directory Sync and SCIM
Consider the developer’s guide to directory sync and scim. Version the assumption, not just the code. Write down what you expect from the peer, and make the failure loud when it stops being true, because the alternative is a connection that half works for six weeks.
Version the assumption, not just the code. Write down what you expect from the peer, and make the failure loud when it stops being true, because the alternative is a connection that half works for six weeks.
Where this leaves us
None of this is exotic. It is the ordinary discipline of deciding what you own, writing down what you assume, and making the failures loud enough to notice.
If you are working through the same problem and want to compare notes, the docs cover the mechanics and the console shows the behaviour on your own data.
Everything here, already built
Sign-in, enterprise SSO, directory provisioning, roles and an audit trail behind one API.