# `flyoverhead.openwrt.dropbear`

OpenWRT `dropbear` configuration
- configure dropbear settings

## Role Variables

| Variable | Descritpion | Status | Type | Example |
| :--- | :--- | :--- | :--- | :--- |
| `dropbear` | Dropbear settings configuration |  | `dictionary` |  |
|  `enable` | Enable starting dropbear at system boot | `required` | `boolean` | `1` |
|  `verbose` | Enable verbose output by the start scrip | `optional` | `boolean` | `0` |
|  `BannerFile` | Name of a file to be printed before the user has authenticated successfully | `optional` | `string` | `7` |
|  `PasswordAuth` | Allow authenticating with passwords | `optional` | `boolean` | `1` |
|  `Port` | SSH service listening port | `required` | `integer` | `22` |
|  `RootPasswordAuth` | Allow authenticating as root with passwords | `optional` | `boolean` | `1` |
|  `RootLogin` | Allow SSH logins as root | `optional` | `boolean` | `1` |
|  `GatewayPorts` | Allow remote hosts to connect to forwarded port | `optional` | `boolean` | `0` |
|  `Interface` | Limit connections to specified network interface | `optional` | `string` | `lan` |
|  `keyfile` | Path to host key file | `optional` | `string` | `/etc/dropbear/authorized_keys` |
|  `SSHKeepAlive` | Keep alive | `optional` | `integer` | `300` |
|  `IdleTimeout` | Idle timeout | `optional` | `integer` | `0` |
|  `mdns` | Enable announcing the service via mDNS | `optional` | `boolean` | `1` |
|  `MaxAuthTries` | Amount of password entering retries before SSH server closes the connection | `optional` | `integer` | `3` |
|  `RecvWindowSize` | Per-channel receive window buffer size | `optional` | `integer` | `24576` |

> Note: multiple public keys can be added to `authorized_keys` file in `files` directory

## Dependencies

| Name | Description |
| :--- | :--- |
| `Ansible Role: openwrt` | [Ansible role by gekmihesg](https://github.com/gekmihesg/ansible-openwrt) for managing OpenWRT and derivatives |

## Example Playbook

```yaml
- hosts: openwrt
  roles:
      - role: flyoverhead.openwrt.dropbear
```

## License

[GNU General Public License v3.0](https://www.gnu.org/licenses/gpl-3.0.txt)

## Author Information

fly0v3rH34D

## References

- https://openwrt.org/docs/guide-user/base-system/dropbear