6afb255d97
these changes were generated with nixq 0.0.2, by running nixq ">> lib.mdDoc[remove] Argument[keep]" --batchmode nixos/**.nix nixq ">> mdDoc[remove] Argument[keep]" --batchmode nixos/**.nix nixq ">> Inherit >> mdDoc[remove]" --batchmode nixos/**.nix two mentions of the mdDoc function remain in nixos/, both of which are inside of comments. Since lib.mdDoc is already defined as just id, this commit is a no-op as far as Nix (and the built manual) is concerned.
322 lines
10 KiB
Nix
322 lines
10 KiB
Nix
{
|
|
config,
|
|
lib,
|
|
pkgs,
|
|
...
|
|
}:
|
|
with lib; let
|
|
cfg = config.services.bitwarden-directory-connector-cli;
|
|
in {
|
|
options.services.bitwarden-directory-connector-cli = {
|
|
enable = mkEnableOption "Bitwarden Directory Connector";
|
|
|
|
package = mkPackageOption pkgs "bitwarden-directory-connector-cli" {};
|
|
|
|
domain = mkOption {
|
|
type = types.str;
|
|
description = "The domain the Bitwarden/Vaultwarden is accessible on.";
|
|
example = "https://vaultwarden.example.com";
|
|
};
|
|
|
|
user = mkOption {
|
|
type = types.str;
|
|
description = "User to run the program.";
|
|
default = "bwdc";
|
|
};
|
|
|
|
interval = mkOption {
|
|
type = types.str;
|
|
default = "*:0,15,30,45";
|
|
description = "The interval when to run the connector. This uses systemd's OnCalendar syntax.";
|
|
};
|
|
|
|
ldap = mkOption {
|
|
description = ''
|
|
Options to configure the LDAP connection.
|
|
If you used the desktop application to test the configuration you can find the settings by searching for `ldap` in `~/.config/Bitwarden\ Directory\ Connector/data.json`.
|
|
'';
|
|
default = {};
|
|
type = types.submodule ({
|
|
config,
|
|
options,
|
|
...
|
|
}: {
|
|
freeformType = types.attrsOf (pkgs.formats.json {}).type;
|
|
|
|
config.finalJSON = builtins.toJSON (removeAttrs config (filter (x: x == "finalJSON" || ! options.${x}.isDefined or false) (attrNames options)));
|
|
|
|
options = {
|
|
finalJSON = mkOption {
|
|
type = (pkgs.formats.json {}).type;
|
|
internal = true;
|
|
readOnly = true;
|
|
visible = false;
|
|
};
|
|
|
|
ssl = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = "Whether to use TLS.";
|
|
};
|
|
startTls = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = "Whether to use STARTTLS.";
|
|
};
|
|
|
|
hostname = mkOption {
|
|
type = types.str;
|
|
description = "The host the LDAP is accessible on.";
|
|
example = "ldap.example.com";
|
|
};
|
|
|
|
port = mkOption {
|
|
type = types.port;
|
|
default = 389;
|
|
description = "Port LDAP is accessible on.";
|
|
};
|
|
|
|
ad = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = "Whether the LDAP Server is an Active Directory.";
|
|
};
|
|
|
|
pagedSearch = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = "Whether the LDAP server paginates search results.";
|
|
};
|
|
|
|
rootPath = mkOption {
|
|
type = types.str;
|
|
description = "Root path for LDAP.";
|
|
example = "dc=example,dc=com";
|
|
};
|
|
|
|
username = mkOption {
|
|
type = types.str;
|
|
description = "The user to authenticate as.";
|
|
example = "cn=admin,dc=example,dc=com";
|
|
};
|
|
};
|
|
});
|
|
};
|
|
|
|
sync = mkOption {
|
|
description = ''
|
|
Options to configure what gets synced.
|
|
If you used the desktop application to test the configuration you can find the settings by searching for `sync` in `~/.config/Bitwarden\ Directory\ Connector/data.json`.
|
|
'';
|
|
default = {};
|
|
type = types.submodule ({
|
|
config,
|
|
options,
|
|
...
|
|
}: {
|
|
freeformType = types.attrsOf (pkgs.formats.json {}).type;
|
|
|
|
config.finalJSON = builtins.toJSON (removeAttrs config (filter (x: x == "finalJSON" || ! options.${x}.isDefined or false) (attrNames options)));
|
|
|
|
options = {
|
|
finalJSON = mkOption {
|
|
type = (pkgs.formats.json {}).type;
|
|
internal = true;
|
|
readOnly = true;
|
|
visible = false;
|
|
};
|
|
|
|
removeDisabled = mkOption {
|
|
type = types.bool;
|
|
default = true;
|
|
description = "Remove users from bitwarden groups if no longer in the ldap group.";
|
|
};
|
|
|
|
overwriteExisting = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = "Remove and re-add users/groups, See https://bitwarden.com/help/user-group-filters/#overwriting-syncs for more details.";
|
|
};
|
|
|
|
largeImport = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = "Enable if you are syncing more than 2000 users/groups.";
|
|
};
|
|
|
|
memberAttribute = mkOption {
|
|
type = types.str;
|
|
description = "Attribute that lists members in a LDAP group.";
|
|
example = "uniqueMember";
|
|
};
|
|
|
|
creationDateAttribute = mkOption {
|
|
type = types.str;
|
|
description = "Attribute that lists a user's creation date.";
|
|
example = "whenCreated";
|
|
};
|
|
|
|
useEmailPrefixSuffix = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = "If a user has no email address, combine a username prefix with a suffix value to form an email.";
|
|
};
|
|
emailPrefixAttribute = mkOption {
|
|
type = types.str;
|
|
description = "The attribute that contains the users username.";
|
|
example = "accountName";
|
|
};
|
|
emailSuffix = mkOption {
|
|
type = types.str;
|
|
description = "Suffix for the email, normally @example.com.";
|
|
example = "@example.com";
|
|
};
|
|
|
|
users = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = "Sync users.";
|
|
};
|
|
userPath = mkOption {
|
|
type = types.str;
|
|
description = "User directory, relative to root.";
|
|
default = "ou=users";
|
|
};
|
|
userObjectClass = mkOption {
|
|
type = types.str;
|
|
description = "Class that users must have.";
|
|
default = "inetOrgPerson";
|
|
};
|
|
userEmailAttribute = mkOption {
|
|
type = types.str;
|
|
description = "Attribute for a users email.";
|
|
default = "mail";
|
|
};
|
|
userFilter = mkOption {
|
|
type = types.str;
|
|
description = "LDAP filter for users.";
|
|
example = "(memberOf=cn=sales,ou=groups,dc=example,dc=com)";
|
|
default = "";
|
|
};
|
|
|
|
groups = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = "Whether to sync ldap groups into BitWarden.";
|
|
};
|
|
groupPath = mkOption {
|
|
type = types.str;
|
|
description = "Group directory, relative to root.";
|
|
default = "ou=groups";
|
|
};
|
|
groupObjectClass = mkOption {
|
|
type = types.str;
|
|
description = "A class that groups will have.";
|
|
default = "groupOfNames";
|
|
};
|
|
groupNameAttribute = mkOption {
|
|
type = types.str;
|
|
description = "Attribute for a name of group.";
|
|
default = "cn";
|
|
};
|
|
groupFilter = mkOption {
|
|
type = types.str;
|
|
description = "LDAP filter for groups.";
|
|
example = "(cn=sales)";
|
|
default = "";
|
|
};
|
|
};
|
|
});
|
|
};
|
|
|
|
secrets = {
|
|
ldap = mkOption {
|
|
type = types.str;
|
|
description = "Path to file that contains LDAP password for user in {option}`ldap.username";
|
|
};
|
|
|
|
bitwarden = {
|
|
client_path_id = mkOption {
|
|
type = types.str;
|
|
description = "Path to file that contains Client ID.";
|
|
};
|
|
client_path_secret = mkOption {
|
|
type = types.str;
|
|
description = "Path to file that contains Client Secret.";
|
|
};
|
|
};
|
|
};
|
|
};
|
|
|
|
config = mkIf cfg.enable {
|
|
users.groups."${cfg.user}" = {};
|
|
users.users."${cfg.user}" = {
|
|
isSystemUser = true;
|
|
group = cfg.user;
|
|
};
|
|
|
|
systemd = {
|
|
timers.bitwarden-directory-connector-cli = {
|
|
description = "Sync timer for Bitwarden Directory Connector";
|
|
wantedBy = ["timers.target"];
|
|
after = ["network-online.target"];
|
|
timerConfig = {
|
|
OnCalendar = cfg.interval;
|
|
Unit = "bitwarden-directory-connector-cli.service";
|
|
Persistent = true;
|
|
};
|
|
};
|
|
|
|
services.bitwarden-directory-connector-cli = {
|
|
description = "Main process for Bitwarden Directory Connector";
|
|
path = [pkgs.jq];
|
|
|
|
environment = {
|
|
BITWARDENCLI_CONNECTOR_APPDATA_DIR = "/tmp";
|
|
BITWARDENCLI_CONNECTOR_PLAINTEXT_SECRETS = "true";
|
|
};
|
|
|
|
preStart = ''
|
|
set -eo pipefail
|
|
|
|
# create the config file
|
|
${lib.getExe cfg.package} data-file
|
|
touch /tmp/data.json.tmp
|
|
chmod 600 /tmp/data.json{,.tmp}
|
|
|
|
${lib.getExe cfg.package} config server ${cfg.domain}
|
|
|
|
# now login to set credentials
|
|
export BW_CLIENTID="$(< ${escapeShellArg cfg.secrets.bitwarden.client_path_id})"
|
|
export BW_CLIENTSECRET="$(< ${escapeShellArg cfg.secrets.bitwarden.client_path_secret})"
|
|
${lib.getExe cfg.package} login
|
|
|
|
jq '.authenticatedAccounts[0] as $account
|
|
| .[$account].directoryConfigurations.ldap |= $ldap_data
|
|
| .[$account].directorySettings.organizationId |= $orgID
|
|
| .[$account].directorySettings.sync |= $sync_data' \
|
|
--argjson ldap_data ${escapeShellArg cfg.ldap.finalJSON} \
|
|
--arg orgID "''${BW_CLIENTID//organization.}" \
|
|
--argjson sync_data ${escapeShellArg cfg.sync.finalJSON} \
|
|
/tmp/data.json \
|
|
> /tmp/data.json.tmp
|
|
|
|
mv -f /tmp/data.json.tmp /tmp/data.json
|
|
|
|
# final config
|
|
${lib.getExe cfg.package} config directory 0
|
|
${lib.getExe cfg.package} config ldap.password --secretfile ${cfg.secrets.ldap}
|
|
'';
|
|
|
|
serviceConfig = {
|
|
Type = "oneshot";
|
|
User = "${cfg.user}";
|
|
PrivateTmp = true;
|
|
ExecStart = "${lib.getExe cfg.package} sync";
|
|
};
|
|
};
|
|
};
|
|
};
|
|
|
|
meta.maintainers = with maintainers; [Silver-Golden];
|
|
}
|