Support/Commissions & Briefs/How authentication is scoped
Commissions & Briefs

HOW AUTHENTICATION IS SCOPED

2,294 views
authenticationsecurity

Authentication requirements are scoped by mapping user roles, identity providers, and data access tiers during technical discovery to establish exact development effort before implementation begins.

Authentication is scoped around the explicit trust boundaries, user roles, and compliance requirements of your application rather than generic boilerplate. The Technology department evaluates identity providers, session models, and role-based access controls during initial technical discovery to produce a fixed architecture and timeline.

Information required during discovery To determine the scope of an authentication system, the Technology department requires functional parameters before drafting a specification or bespoke quote. You must provide: - User types and hierarchy: A definitive breakdown of every actor interacting with the platform (for instance, public consumers, paying members, internal administrators, or third-party auditors). - Identity provider preferences: Confirmation of whether the platform relies on standard email and password credentials, passwordless magic links, social OAuth (such as Google, Apple, or GitHub), or enterprise Single Sign-On (SSO via SAML or OIDC). - Session and security policies: Rules regarding concurrent sessions, session lifetime, inactivity timeouts, multi-factor authentication (MFA) enforcement, and account lockout thresholds. - Regulatory and data residency demands: Geographic or industry compliance mandates (such as UK GDPR) that dictate where credential data, audit logs, and tokens may reside.

If these details are incomplete, bespoke scoping will pause until clarifications are logged via Ask Xylo.

Scoping tiers and technical implementation Authentication rarely exists in isolation; it dictates how your database schemas, API gateways, and client applications interact. We classify authentication builds into three distinct tiers:

1. Basic direct authentication: Single-role or simple two-role systems using secure password hashing (Argon2id or bcrypt) or magic links. Scoped for low-complexity web apps where external directory synchronisation is not required. 2. Role-Based Access Control (RBAC) and social integrations: Multi-role models where permissions govern access to discrete API routes and database tables. This tier includes OAuth 2.0 social logins, automated password reset flows, MFA via TOTP, and transactional security emails. 3. Enterprise federation and multi-tenancy: Complex architectures requiring SAML 2.0 or OIDC integration with identity providers such as Okta, Azure AD, or Google Workspace. This tier covers tenant isolation, automated SCIM provisioning, granular audit trails, and strict session revocation protocols across microservices.

Package builds include pre-defined authentication layers as stated on the packages page. Any requirement that diverges from those packaged boundaries is scoped as a bespoke component.

Sequence of events The scoping and integration workflow runs strictly within studio hours, Monday to Thursday, 09:00 to 17:00 GMT: 1. Brief submission: You submit your technical requirements and user-flow diagrams through Ask Xylo. 2. Assessment: Operations & Client Services confirms receipt within our 24-hour first reply target and assigns the brief to the Technology department. 3. Architecture review: The Technology department models the token lifecycle (JWT vs server-side sessions), storage mechanisms, and cryptographic requirements. 4. Bespoke quotation: A detailed proposal containing the fixed technical scope, deliverables, and architecture outline is delivered within 48 hours of receiving a complete brief. 5. Spec freeze and execution: Once agreed and funded, the identity model is frozen. Core authentication routes and middleware are engineered and tested prior to building user-facing account features.

Common failure cases and edge cases Authentication projects encounter delays when architectural assumptions are made without technical validation: - Late introduction of multi-tenancy: Attempting to convert a single-tenant RBAC system into an organisation-based multi-tenant system mid-build invalidates the database schema and requires a complete rescoping. - Missing third-party developer access: Scoping external identity providers requires sandbox environments and client credentials. Delays in granting these credentials stall API verification. - Ambiguous permission matrices: Supplying a list of user roles without defining their exact read, write, and delete permissions against specific data objects leads to friction during technical sign-off. - Unplanned migration data: Migrating existing user bases with legacy password hashes requires custom migration scripts and fallbacks that must be calculated upfront.

Authentication scoping checklist Ensure the following items are prepared before requesting a technical brief review: - [ ] Exhaustive list of user roles and their respective data access permissions. - [ ] List of required identity providers (local credentials, OAuth providers, or SAML/SSO). - [ ] Mandatory security controls (MFA, password complexity rules, session timeout lengths). - [ ] Existing user migration requirements, including export format and hash algorithms. - [ ] Known regulatory standards affecting user identity storage.

Was this helpful?

Tell us honestly. It is read by the people who write these pages.

If this didn't answer your question, ask Xylo.

Back to Commissions & Briefs