@auth/core
Version:
Authentication for the Web.
134 lines • 5.24 kB
TypeScript
/**
* <div class="provider" style={{display: "flex", justifyContent: "space-between", alignItems: "center"}}>
* <span style={{fontSize: "1.35rem" }}>
* Built-in sign in with <b>BankID Norway</b> integration.
* </span>
* <a href="https://bankid.no" style={{backgroundColor: "black", padding: "12px", borderRadius: "100%" }}>
* <img style={{display: "block"}} src="https://authjs.dev/img/providers/bankid-no.svg" width="24"/>
* </a>
* </div>
*
* @module providers/bankid-no
*/
import type { OIDCConfig, OIDCUserConfig } from "./index.js";
/**
* @see [Core conepts - ID Token](https://confluence.bankidnorge.no/confluence/pdoidcl/technical-documentation/core-concepts/id-token)
* @see [userinfo](https://confluence.bankidnorge.no/confluence/pdoidcl/technical-documentation/api/userinfo)
*/
export interface BankIDNorwayProfile {
exp: number;
iat: number;
/** Epoc time */
auth_time: number;
jti: string;
iss: string;
/** Always client_id */
aud: string;
sub: string;
typ: "ID";
/** Equals client_id */
azp: string;
session_state: string;
at_hash: string;
name: string;
given_name: string;
family_name: string;
birthdate: string;
updated_at: number;
/**
* Uniform Resource Name for [IDP option](https://confluence.bankidnorge.no/confluence/pdoidcl/technical-documentation/core-concepts/identity-providers) being used,
* including Level of Assurance (LoA).
* @example
* ```
* urn:bankid:bid;LOA=4
* ```
*/
acr: string;
sid: string;
/**
* Name of [IDP option](https://confluence.bankidnorge.no/confluence/pdoidcl/technical-documentation/core-concepts/identity-providers) being used to authenticate the end-user.
* If the end-user is subject to authentication step-up,
* note that this value may differ from any `amr` value specified
* in the `login_hint` parameter of the [authorize](https://confluence.bankidnorge.no/confluence/pdoidcl/technical-documentation/api/authorize) endpoint.
*/
amr: "BID" | "BIM" | "BIS";
/** Personal Identifier (PID) / Serial Number) from associated BankID certificate. */
bankid_altsub: string;
/**
* In case of BID or BIM, the issuer of the end user certificate is returned.
* @example
* ```
* CN=BankID Bankenes ID-tjeneste Bank CA 2,
* OU=988477052,
* O=Bankenes ID-tjeneste AS,*
* C=NO;OrginatorId=9775;OriginatorName=Gjensidige Bank RA 1
* ```
*/
originator: string;
additionalCertInfo: {
certValidFrom: number;
serialNumber: string;
keyAlgorithm: string;
keySize: string;
policyOid: string;
certQualified: boolean;
certValidTo: number;
versionNumber: string;
subjectName: string;
};
/** Currently used as an input parameter for the [securityData](https://confluence.bankidnorge.no/confluence/pdoidcl/technical-documentation/api/securitydata) endpoint of the [Fraud Data](https://confluence.bankidnorge.no/confluence/pdoidcl/technical-documentation/advanced-topics/fraud-data) service */
tid: string;
/** Only returned from the `userinfo_endpoint` */
email?: string;
/**
* [Norwegian National Identity Number (fødselsnummer)](https://www.skatteetaten.no/en/person/foreign/norwegian-identification-number/national-identity-number). It can be an alternative to `sub`.
* Requires `nnin_altsub` scope at the [authorize](https://confluence.bankidnorge.no/confluence/pdoidcl/technical-documentation/api/authorize) endpoint.
* @example
* ```
* 181266*****
* ```
*/
nnin_altsub?: string;
}
/**
* ### Setup
*
* #### Callback URL
* ```
* https://example.com/api/auth/callback/bankid-no
* ```
*
* #### Configuration
* ```ts
* import { Auth } from "@auth/core"
* import BankIDNorge from "@auth/core/providers/bankid-no"
*
* const request = new Request(origin)
* const response = await Auth(request, {
* providers: [
* Auth0({
* clientId: AUTH_BANKID_NO_ID,
* clientSecret: AUTH_BANKID_NO_SECRET,
* }),
* ],
* })
* ```
*
* ### Resources
*
* - [OpenID Connect Provider from BankID](https://confluence.bankidnorge.no/confluence/pdoidcl)
*
* ### Notes
*
* The BankID Norge provider comes with a [default configuration](https://github.com/nextauthjs/next-auth/blob/main/packages/core/src/providers/bankid-no.ts). To override the defaults for your use case, check out [customizing a built-in OAuth provider](https://authjs.dev/guides/configuring-oauth-providers).
*
* ## Help
*
* If you think you found a bug in the default configuration, you can [open an issue](https://authjs.dev/new/provider-issue).
*
* Auth.js strictly adheres to the specification and it cannot take responsibility for any deviation from
* the spec by the provider. You can open an issue, but if the problem is non-compliance with the spec,
* we might not pursue a resolution. You can ask for more help in [Discussions](https://authjs.dev/new/github-discussions).
*/
export default function BankIDNorway(config: OIDCUserConfig<BankIDNorwayProfile>): OIDCConfig<BankIDNorwayProfile>;
//# sourceMappingURL=bankid-no.d.ts.map