Home›Telecom›Non-Functional Architecture›Identity & Access (IAM)← All modules
Non-functional architecture

Identity & Access Management

The IAM module governs who can access what across the platform — managing subscriber and agent identities, enforcing authentication requirements, controlling API access permissions, and providing single sign-on across all channels and tools.

Authentication Authorisation Identity Management API Access Control SSO & Federation Access Audit
On this pageAt a glanceHow it worksCore CapabilitiesStorage & PersistenceDesign PrinciplesWhere AI helpsStandards

At a glance

Controls who can sign in and what they can do, for customers, agents and partners.

Key data

User / identityRolePermissionSession / token

Receives from

  • Channels
  • Enterprise directory
Identity & Access (IAM)

Sends to

  • Every BSS module (authorisation)

How it works

The main steps, end to end.

  1. 1
    User signs in with password, OTP or SSO
  2. 2
    Identity verified and session issued
  3. 3
    Roles and permissions checked per request
  4. 4
    Access logged for audit
  5. 5
    Identity changes and removals managed

Core Capabilities

What IAM provides across the platform

Authentication

Verify Identity
  • Username and password authentication for subscribers and agents
  • Multi-factor authentication (MFA): OTP via SMS or email
  • Step-up authentication for sensitive actions: payment change, account transfer
  • Biometric authentication support for mobile app channel
  • Account lockout and brute-force protection policies
  • Password strength enforcement and rotation policies for agent accounts
OTP ServiceSubscriber Store

Authorisation

Control Access
  • Role-based access control (RBAC) for all platform users and services
  • Subscriber roles: standard, business, family group owner
  • Agent roles: care agent, billing agent, sales agent, supervisor, admin
  • Permission sets defined at resource level: read, write, approve, override
  • Dynamic permission evaluation at request time — not cached
  • Least-privilege principle enforced across all roles
RBAC EnginePermission Store

Identity Management

Manage Identities
  • Subscriber identity lifecycle: registration, update, suspension, deletion
  • Agent identity provisioning and deprovisioning on HR event
  • Credential management: password reset, MFA device enrolment
  • Identity linking: platform account linked to external identity provider
  • Profile attributes: contact details, preferred language, notification preferences
Party ManagementHR System

API Access Control

Secure APIs
  • API key and OAuth token management for service-to-service calls
  • Token validation at API gateway for every inbound request
  • Scoped access tokens: each service receives only the permissions it needs
  • Token expiry and rotation policies per API consumer type
  • Rate limiting per API key to prevent abuse
API GatewayToken Store

SSO & Federation

Single Sign-on
  • Single sign-on across self-care portal, mobile app and care tools
  • Session sharing with configurable inactivity timeout
  • Identity federation with external providers where required
  • Token-based session: JWT issued on login, validated on each request
  • Logout propagation: single logout invalidates all active sessions
OTP ServiceJWT Store

Access Audit

Record & Review
  • Every login, logout and authentication event logged with timestamp and device
  • Failed authentication attempts tracked for anomaly detection
  • Permission grant and revocation events recorded
  • Privileged action audit: admin overrides, role assignments
  • Audit log retained for configurable period for compliance review
Audit Log StoreSecurity Operations

Storage & Persistence

How and where IAM stores its data

Document Data Store

Identity records
  • Subscriber and agent identity documents
  • Role and permission assignments
  • MFA device enrolment records
  • Session state documents

Credential Store

Secrets
  • Hashed password credentials — never plaintext
  • API keys and service tokens (hashed)
  • MFA seed values encrypted at rest
  • Token signing keys with rotation policy

Audit Log Store

Access records
  • Every authentication and authorisation event
  • Failed login attempts and lockout events
  • Role grant and revocation records
  • Privileged action audit trail

Design Principles

Key architectural decisions behind IAM

RBAC at Every Layer

Role-based access control is enforced at the API gateway, at the service layer and at the data layer. Passing authentication does not guarantee authorisation — every request is evaluated against the caller's role and permissions at the time of the request, not at session start.

Zero Trust API Access

No service-to-service call is trusted by default. Every inter-service API call presents a scoped access token that is validated by the API gateway on every request. Tokens are short-lived and scoped to the minimum permissions needed for the calling service.

Immutable Audit Log

Every identity and access event is written to an immutable audit log that cannot be modified or deleted within its retention period. This provides an unalterable record of all authentication and authorisation decisions for security investigations and regulatory compliance.

AI opportunity
Where AI helps
Risk-based authentication

Ask for extra verification only when a login looks unusual.

Account takeover detection

Spot credential stuffing and SIM-swap attacks.

More in 30 AI & ML use cases and AIOps for BSS.

Standards & references
OAuth 2.0 / OpenID ConnectStandard sign-in and authorisation protocols
TMF672User Roles and Permissions API