Class HOTP

constructor

• new HOTP(
      config?: {
          algorithm?: string;
          counter?: number;
          digits?: number;
          issuer?: string;
          issuerInLabel?: boolean;
          label?: string;
          secret?: string | Secret;
      },
  ): HOTP

  Creates an HOTP object.

  Parameters

  • Optionalconfig: {
        algorithm?: string;
        counter?: number;
        digits?: number;
        issuer?: string;
        issuerInLabel?: boolean;
        label?: string;
        secret?: string | Secret;
    } = {}

    Configuration options.

    • Optionalalgorithm?: string

      HMAC hashing algorithm.

    • Optionalcounter?: number

      Initial counter value.

    • Optionaldigits?: number

      Token length.

    • Optionalissuer?: string

      Account provider.

    • OptionalissuerInLabel?: boolean

      Include issuer prefix in label.

    • Optionallabel?: string

      Account label.

    • Optionalsecret?: string | Secret

      Secret key.

  Returns HOTP

algorithm

counter

digits

issuer

issuerInLabel

label

secret

Staticdefaults

• get defaults(): {
      algorithm: string;
      counter: number;
      digits: number;
      issuer: string;
      issuerInLabel: boolean;
      label: string;
      window: number;
  }

  Default configuration.

  Returns {
      algorithm: string;
      counter: number;
      digits: number;
      issuer: string;
      issuerInLabel: boolean;
      label: string;
      window: number;
  }

generate

• generate(config?: { counter?: number }): string

  Generates an HOTP token.

  Parameters

  • Optionalconfig: { counter?: number } = {}

    Configuration options.

    • Optionalcounter?: number

      Counter value.

  Returns string

  Token.

toString

• toString(): string

  Returns a Google Authenticator key URI.

  Returns string

  URI.

validate

• validate(
      config: { counter?: number; token: string; window?: number },
  ): null | number

  Validates an HOTP token.

  Parameters

  • config: { counter?: number; token: string; window?: number }

    Configuration options.

    • Optionalcounter?: number

      Counter value.

    • token: string

      Token value.

    • Optionalwindow?: number

      Window of counter values to test.

  Returns null | number

  Token delta or null if it is not found in the search window, in which case it should be considered invalid.

Staticgenerate

• generate(
      config: {
          algorithm?: string;
          counter?: number;
          digits?: number;
          secret: Secret;
      },
  ): string

  Generates an HOTP token.

  Parameters

  • config: { algorithm?: string; counter?: number; digits?: number; secret: Secret }

    Configuration options.

    • Optionalalgorithm?: string

      HMAC hashing algorithm.

    • Optionalcounter?: number

      Counter value.

    • Optionaldigits?: number

      Token length.

    • secret: Secret

      Secret key.

  Returns string

  Token.

Staticvalidate

• validate(
      config: {
          algorithm?: string;
          counter?: number;
          digits?: number;
          secret: Secret;
          token: string;
          window?: number;
      },
  ): null
  | number

  Validates an HOTP token.

  Parameters

  • config: {
        algorithm?: string;
        counter?: number;
        digits?: number;
        secret: Secret;
        token: string;
        window?: number;
    }

    Configuration options.

    • Optionalalgorithm?: string

      HMAC hashing algorithm.

    • Optionalcounter?: number

      Counter value.

    • Optionaldigits?: number

      Token length.

    • secret: Secret

      Secret key.

    • token: string

      Token value.

    • Optionalwindow?: number

      Window of counter values to test.

  Returns null | number

  Token delta or null if it is not found in the search window, in which case it should be considered invalid.