.. bfh-ssp-tools: BFH Self-Service Portal Tools

.. Copyright (C) 2025-2026 Daniel Baumann <daniel@debian.org>
..
.. SPDX-License-Identifier: GPL-3.0+
..
.. This program is free software: you can redistribute it and/or modify
.. it under the terms of the GNU General Public License as published by
.. the Free Software Foundation, either version 3 of the License, or
.. (at your option) any later version.
..
.. This program is distributed in the hope that it will be useful,
.. but WITHOUT ANY WARRANTY; without even the implied warranty of
.. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.. GNU General Public License for more details.
..
.. You should have received a copy of the GNU General Public License
.. along with this program.  If not, see <https://www.gnu.org/licenses/>.

=============
bfh-ssp-tools
=============

-----------------------------
BFH Self-Service Portal Tools
-----------------------------

:manual section: 7
:manual group: BFH

Description
===========

Tools for BFH Self-Service Portal <https://bfh.science>.

Download
========

| Upstream Releases:
| https://apt.progress-linux.org/archive/upstream/bfh-ssp-tools

| Upstream Sources:
| https://git.progress-linux.org/upstream/bfh-ssp-tools

| Debian Releases:
| https://apt.progress-linux.org/archive/debian/bfh-ssp-tools

| Debian Sources:
| https://git.progress-linux.org/debian/bfh-ssp-tools

Installation
============

Source
------

| $ sudo apt install git ca-certificates make python3-docutils
| $ git clone https://git.progress-linux.org/upstream/bfh-ssp-tools
| $ cd bfh-ssp-tools && sudo make install

Debian 13 (trixie) with Progress Linux repositories
---------------------------------------------------

| $ sudo apt install bfh-ssp-tools

Usage
=====

/usr/libexec/bfh-ssp/enable-openstack:
  enable-openstack ACCOUNT PROJECT

/usr/libexec/bfh-ssp/create-storage:
  create-storage ACCOUNT SHARE
  create-storage bad9 Users/bad9
  create-storage bad9 Services/Foo-bar

/usr/libexec/bfh-ssp/update-ssh-key:
  update-ssh-key USER KEY
  update-ssh-key bad9 "ssh-ed25519 [...]"
  update-ssh-key bad9 ssh-key.pub
  update-ssh-key bad9 disabled

See also
========

| bfh-tools(7)

Homepage
========

More information about bfh-ssp-tools and the BFH Self-Service Portal can be found on the homepage (https://forgejo.bfh.info/ssp).

Contact
=======

Bug reports, feature requests, help, patches, support and everything else are welcome on the BFH Linux System Administration Mailing List <bfh-linux-sysadmin@lists.bfh.science>.

Authors
=======

bfh-ssp-tools were written by Daniel Baumann <daniel@debian.org>.
