refresh2FASecret method

Future<RestApiResponse> refresh2FASecret(String appname, String token)

Erneuert ein bestehendes 2FA-Secret

Generiert ein neues TOTP-Secret für eine bereits konfigurierte 2FA-Anwendung. Erfordert ein gültiges Token zur Autorisierung.

appname - Name der Anwendung (z.B. "GSD-DFApp") token - Gültiges 2FA-Token zur Autorisierung der Erneuerung

Returns: RestApiResponse mit dem neuen 2FA-Secret und Konfigurationsdaten

Nach der Erneuerung:

• Das alte Secret wird ungültig
• Ein neues Secret wird generiert
• Authenticator-Apps müssen neu konfiguriert werden

Beispiel:

RestApiResponse response = await api.v1.authentication.refresh2FASecret(
  "GSD-DFApp",
  "123456"
);
if (response.isOk) {
  String newSecret = response.data['secret'];
  // Benutzer muss Authenticator-App neu einrichten
}

Implementation

Future<RestApiResponse> refresh2FASecret(String appname, String token) {
  return _runtime.execute(
    ApiRequest<RestApiResponse>(
      method: ApiHttpMethod.patch,
      version: ApiVersion.v1,
      path: '/2fa/secret',
      queryParameters: <String, String>{'app': appname},
      body: jsonEncode(<String, dynamic>{'token': token}),
      authentication: AuthenticationPolicy.session,
      responsePolicy: _responsePolicy,
      operationId: 'v1.authentication.refresh2FASecret',
    ),
  );
}