Database administration tool for non-admin users, rewrite of https://git.pvv.ntnu.no/Projects/mysql-admutils
Go to file
Oystein Kristoffer Tveit e6e05df77e
flake.nix: replace fenix with rust-overlay
2024-07-10 17:08:53 +02:00
src make database connection timeout configurable 2024-07-09 21:36:12 +02:00
.gitignore Initial commit 2024-04-20 03:38:29 +02:00
Cargo.lock Add large parts of the permission editor 2024-07-09 19:51:59 +02:00
Cargo.toml Add large parts of the permission editor 2024-07-09 19:51:59 +02:00
LICENSE Initial commit 2024-04-20 03:38:29 +02:00
README.md flatten subcommands and add better doc comments 2024-07-09 19:54:27 +02:00
example-config.toml make database connection timeout configurable 2024-07-09 21:36:12 +02:00
flake.lock flake.nix: replace fenix with rust-overlay 2024-07-10 17:08:53 +02:00
flake.nix flake.nix: replace fenix with rust-overlay 2024-07-10 17:08:53 +02:00

README.md

mysqladm-rs

Work in progress rewrite of https://git.pvv.ntnu.no/Projects/mysql-admutils

Installation

The resulting binary will probably need to be marked as either SUID or SGID to work in a multi-user environment. The UID/GID of the binary should have access to the config file, which contains secrets to log in to an admin-like MySQL user. Preferrably, this UID/GID should not be root, in order to minimize the potential damage that can be done in case of security vulnerabilities in the program.

Development and testing

Ensure you have a rust toolchain installed.

In order to set up a test instance of mariadb in a docker container, run the following command:

docker run --rm --name mariadb -e MYSQL_ROOT_PASSWORD=secret -d mariadb:latest

You should then create a config file, and adjust the hostname to the IP address of the docker container.

cp ./example-config.toml ./config.toml
DOCKER_IP_ADDRESS="$(docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' mariadb)"
sed -i "s/host = \"localhost\"/host = \"${DOCKER_IP_ADDRESS}\"/" ./config.toml

You should now be able to connect to the mariadb instance, after building the program and using arguments to specify the config file.

cargo run -- --config-file ./config.toml <args>

# example usage
cargo run -- --config-file ./config.toml create-db "${USER}_testdb"
cargo run -- --config-file ./config.toml create-user "${USER}_testuser"
cargo run -- --config-file ./config.toml edit-db-perm -p "${USER}_testdb:${USER}_testuser:A"
cargo run -- --config-file ./config.toml show-db-perm

To stop and remove the container, run the following command:

docker stop mariadb