{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-authentication",
  "id": "authentication",
  "kind": "mechanism",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-security-core",
    "json": "https://banes-lab.com/json/records/layer/security-core",
    "label": "Security Core",
    "markdown": "https://banes-lab.com/records/layer/security-core.md",
    "ref": "layer:security-core"
  },
  "name": "Authentication",
  "ref": "architecture:authentication",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-identity-proof",
          "json": "https://banes-lab.com/json/records/lexicon/identity-proof",
          "label": "Identity Proof",
          "markdown": "https://banes-lab.com/records/lexicon/identity-proof.md",
          "ref": "lexicon:identity-proof"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-access-control",
          "json": "https://banes-lab.com/json/records/architecture/access-control",
          "label": "Access Control",
          "markdown": "https://banes-lab.com/records/architecture/access-control.md",
          "ref": "architecture:access-control"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-identity-aware-authorization",
          "json": "https://banes-lab.com/json/records/lexicon/identity-aware-authorization",
          "label": "Identity-Aware Authorization",
          "markdown": "https://banes-lab.com/records/lexicon/identity-aware-authorization.md",
          "ref": "lexicon:identity-aware-authorization"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-anonymous-sensitive-access",
          "json": "https://banes-lab.com/json/records/lexicon/anonymous-sensitive-access",
          "label": "Anonymous Sensitive Access",
          "markdown": "https://banes-lab.com/records/lexicon/anonymous-sensitive-access.md",
          "ref": "lexicon:anonymous-sensitive-access"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-user-experience",
          "json": "https://banes-lab.com/json/records/lexicon/user-experience",
          "label": "User Experience",
          "markdown": "https://banes-lab.com/records/lexicon/user-experience.md",
          "ref": "lexicon:user-experience"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-authentication-user-experience",
          "json": "https://banes-lab.com/json/records/tension/authentication-user-experience",
          "label": "Authentication / User Experience",
          "markdown": "https://banes-lab.com/records/tension/authentication-user-experience.md",
          "ref": "tension:authentication-user-experience"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-anonymous-sensitive-access",
          "json": "https://banes-lab.com/json/records/lexicon/anonymous-sensitive-access",
          "label": "Anonymous Sensitive Access",
          "markdown": "https://banes-lab.com/records/lexicon/anonymous-sensitive-access.md",
          "ref": "lexicon:anonymous-sensitive-access"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-mandatory",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-mandatory",
          "label": "mandatory",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-mandatory.md",
          "ref": "vocabulary:severity-mandatory"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-security-privacy-compliance-governance",
          "json": "https://banes-lab.com/json/records/architecture-category/security-privacy-compliance-governance",
          "label": "Security / Privacy / Compliance / Governance",
          "markdown": "https://banes-lab.com/records/architecture-category/security-privacy-compliance-governance.md",
          "ref": "architecture-category:security-privacy-compliance-governance"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-zero-trust-architecture",
          "json": "https://banes-lab.com/json/records/architecture/zero-trust-architecture",
          "label": "Zero Trust Architecture",
          "markdown": "https://banes-lab.com/records/architecture/zero-trust-architecture.md",
          "ref": "architecture:zero-trust-architecture"
        }
      ],
      "relation": "refactors"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-csrf-protection",
          "json": "https://banes-lab.com/json/records/architecture/csrf-protection",
          "label": "CSRF Protection",
          "markdown": "https://banes-lab.com/records/architecture/csrf-protection.md",
          "ref": "architecture:csrf-protection"
        }
      ],
      "relation": "reinforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-session-management",
          "json": "https://banes-lab.com/json/records/architecture/session-management",
          "label": "Session Management",
          "markdown": "https://banes-lab.com/records/architecture/session-management.md",
          "ref": "architecture:session-management"
        }
      ],
      "relation": "required-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-security-privacy-compliance-governance",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-security-privacy-compliance-governance",
          "label": "Security / Privacy / Compliance / Governance",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-security-privacy-compliance-governance.md",
          "ref": "chapter:/ontology#architecture-category-security-privacy-compliance-governance"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-quality-attributes",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-quality-attributes",
          "label": "Quality Attributes",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-quality-attributes.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-quality-attributes"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-security-privacy-compliance",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-security-privacy-compliance",
          "label": "Security Privacy Compliance",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-security-privacy-compliance.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-security-privacy-compliance"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "A mechanism that verifies a caller's claimed identity from a credential before any protected action runs.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-authorization",
      "json": "https://banes-lab.com/json/records/architecture/authorization",
      "label": "Authorization",
      "markdown": "https://banes-lab.com/records/architecture/authorization.md",
      "ref": "architecture:authorization"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-threat-modeling",
      "json": "https://banes-lab.com/json/records/architecture/threat-modeling",
      "label": "Threat Modeling",
      "markdown": "https://banes-lab.com/records/architecture/threat-modeling.md",
      "ref": "architecture:threat-modeling"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [],
  "exemplar": {
    "after": "const credential = requireHeader(request, \"Authorization\");\nconst identity = await authenticator.verify(credential);\nif (!identity) throw new UnauthorizedError();\nreturn loadFooFor(identity.subject);",
    "before": "const userId = request.headers.get(\"X-User-ID\");\nreturn loadFooFor(userId!);",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "user",
    "service",
    "API"
  ],
  "severity": "mandatory"
}