Skip to content

Commit

Permalink
Update security.md
Browse files Browse the repository at this point in the history
Added Duo installation steps.
  • Loading branch information
Ylianst authored Jan 2, 2025
1 parent 54bb017 commit 7aa4061
Showing 1 changed file with 26 additions and 0 deletions.
26 changes: 26 additions & 0 deletions docs/docs/meshcentral/security.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,3 +27,29 @@ Adjust these items in your `config.json`
}
}
```

## Duo 2FA setup

MeshCentral supports Duo as a way for users to add two-factor authentication and Duo offers free accounts for user 10 users. To get started, go to [Duo.com](https://duo.com/) and create a free account. Once logged into Duo, select "Applications" and "Protect an Application" on the left side. Search for "Web SDK" and hit the "Protect" button. You will see a screen with the following information:

- Client ID
- Client secret
- API hostname

Copy these three values in a safe place and do not share these values with anyone. Then, in your MeshCentral config.json file, add the following in the domains section:

```
{
"domains": {
"": {
"duo2factor": {
"integrationkey": "ClientId",
"secretkey": "ClientSecret",
"apihostname": "api-xxxxxxxxxxx.duosecurity.com"
}
}
}
}
```

Restart MeshCentral and your server should now be Duo capable. Users will see an option to enable it in the "My Account" tab. When enabling it, users will be walked thru the process of downloading the mobile application and going thru a trial run on 2FA. Users that get setup will be added to your Duo account under the "Users" / "Users" screen in Duo. Note that the "admin" user is not valid in Duo, so, if you have a user with the name "Admin" in MeshCentral, they will get an error trying to setup Duo.

0 comments on commit 7aa4061

Please sign in to comment.