<!-- review: finished -->

<a id="external-http-auth-radius"></a>

# HTTP Auth RADIUS

This module provides HTTP authentication using the RADIUS protocol.

<a id="installation-13"></a>

## Installation

To [install](https://en.angie.software//angie/docs/installation/index.md#install-packages) the module, use one of the
following packages:

- Angie: `angie-module-http-auth-radius`
- Angie PRO: `angie-pro-module-http-auth-radius`

<a id="loading-the-module-13"></a>

## Loading the Module

Load the module in the `main{}` context:

```nginx
load_module modules/ngx_http_auth_radius_module.so;
```

<a id="configuration-example-89"></a>

## Configuration Example

```nginx
http {

    radius_server "radius_server1" {
        auth_timeout 5;
        resend_limit 3;
        url "127.0.0.1:1812";
        share_secret "secret";
    }

    server {
        listen 80;
        server_name localhost;

        location = / {
            root html;
            index index.html index.htm;

            # RADIUS server configuration
            # The third parameter defines the authentication method:
            # PAP CHAP MSCHAP MSCHAP2 EAPMD5

            auth_radius_server "radius_server1" "PAP";

            # Parameter values:
            # Restricted, "Close Content", off

            auth_radius "Restricted";
        }
    }
}
```

<a id="additional-information-14"></a>

## Additional Information

Detailed documentation and source code are available at:
[https://github.com/ten0s/ngx_http_auth_radius_module/](https://github.com/ten0s/ngx_http_auth_radius_module/)
