Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

enable_radius

enable_radius(**kwargs)

Enables multi-factor authentication (MFA) with the Remote Authentication Dial In User Service (RADIUS) server for an AD Connector or Microsoft AD directory.

See also: AWS API Documentation

Request Syntax

response = client.enable_radius(
    DirectoryId='string',
    RadiusSettings={
        'RadiusServers': [
            'string',
        ],
        'RadiusPort': 123,
        'RadiusTimeout': 123,
        'RadiusRetries': 123,
        'SharedSecret': 'string',
        'AuthenticationProtocol': 'PAP'|'CHAP'|'MS-CHAPv1'|'MS-CHAPv2',
        'DisplayLabel': 'string',
        'UseSameUsername': True|False
    }
)
Parameters
  • DirectoryId (string) --

    [REQUIRED]

    The identifier of the directory for which to enable MFA.

  • RadiusSettings (dict) --

    [REQUIRED]

    A RadiusSettings object that contains information about the RADIUS server.

    • RadiusServers (list) --

      An array of strings that contains the fully qualified domain name (FQDN) or IP addresses of the RADIUS server endpoints, or the FQDN or IP addresses of your RADIUS server load balancer.

      • (string) --
    • RadiusPort (integer) --

      The port that your RADIUS server is using for communications. Your self-managed network must allow inbound traffic over this port from the Directory Service servers.

    • RadiusTimeout (integer) --

      The amount of time, in seconds, to wait for the RADIUS server to respond.

    • RadiusRetries (integer) --

      The maximum number of times that communication with the RADIUS server is attempted.

    • SharedSecret (string) --

      Required for enabling RADIUS on the directory.

    • AuthenticationProtocol (string) --

      The protocol specified for your RADIUS endpoints.

    • DisplayLabel (string) --

      Not currently used.

    • UseSameUsername (boolean) --

      Not currently used.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

    Contains the results of the EnableRadius operation.

Exceptions

  • DirectoryService.Client.exceptions.InvalidParameterException
  • DirectoryService.Client.exceptions.EntityAlreadyExistsException
  • DirectoryService.Client.exceptions.EntityDoesNotExistException
  • DirectoryService.Client.exceptions.ClientException
  • DirectoryService.Client.exceptions.ServiceException