Repozytorium i dokumentacja

Kod źródłowy dostępny jest tutaj: github.com/BeSmartAnd-Pro/bsapmd

Instalacja — wybierz środowisko

  1. Pobierz binarkę:
    Pobierz dla macOS arm64 (Apple Silicon) Pobierz dla macOS amd64 (Intel)

    Linki są automatycznie pobierane z najnowszego wydania na GitHub Releases. Jeśli przycisk jest nieaktywny, sprawdź repozytorium.

  2. Nadaj uprawnienia i przenieś do PATH
    chmod +x ./bsapmd_macos_<arch>
    sudo mv ./bsapmd_macos_<arch> /usr/local/bin/bsapmd
    
  3. Szybki test
    bsapmd --version
    bsapmd --help
    
  1. Pobierz binarkę
    # curl lub wget — wybierz co wolisz
    curl -L -o bsapmd_linux_amd64 "AUTOMATYCZNY_LINK_DO_NAJN."
    # lub:
    # wget -O bsapmd_linux_amd64 "…"
    chmod +x bsapmd_linux_amd64
    sudo mv bsapmd_linux_amd64 /usr/local/bin/bsapmd
    
    Pobierz gotową binarkę (Linux amd64)
  2. Szybki test
    bsapmd --version
    
  1. Pobierz binarkę
    curl -L -o bsapmd_linux_386 "AUTOMATYCZNY_LINK_DO_NAJN."
    chmod +x bsapmd_linux_386
    sudo mv bsapmd_linux_386 /usr/local/bin/bsapmd
    
    Pobierz gotową binarkę (Linux i386)
  2. Szybki test
    bsapmd --version
    

Funkcje

  • Pobieranie certyfikatów z podanego adresu (monitoring SSL).
  • Obsługa wielu certyfikatów przez plik YAML.
  • Opcjonalny restart usługi (np. Apache) po pobraniu.
  • Konfiguracja przez argumenty CLI, zmienne środowiskowe lub plik konfiguracyjny.
  • Przełącznik --version pokazujący wersję aplikacji.

Użycie — argumenty wiersza poleceń

Token, ID certyfikatu i ścieżkę zapisu możesz przekazać bezpośrednio w CLI.

bsapmd --token YOUR_TOKEN --cert_id ID --cert_path /path/to/save/cert.pem --restart "/usr/sbin/service apache2 restart"

Użycie — zmienne środowiskowe

Obsługiwane zmienne:

  • SSLBUDDY_TOKEN — token API do pobierania certyfikatów
  • SSLBUDDY_CERT_ID — ID certyfikatu do pobrania
  • SSLBUDDY_CERT_PATH — ścieżka zapisu certyfikatu
export SSLBUDDY_TOKEN="your_token"
export SSLBUDDY_CERT_ID="ID"
export SSLBUDDY_CERT_PATH="/etc/ssl/certs/cert1.pem"
bsapmd

Użycie — plik konfiguracyjny YAML

Możesz użyć pliku YAML (np. /etc/besmartandpro/sslbuddy.yaml), aby zdefiniować wiele certyfikatów.

token: "your_token"
restart_hook: "/usr/sbin/service apache2 restart"
certificates:
  - id: "ID"
    path: "/etc/ssl/certs/cert1.pem"
  - id: "ID"
    path: "/etc/ssl/certs/cert2.pem"

Aplikacja pobierze każdy zdefiniowany certyfikat i zapisze go we wskazanej ścieżce.

Automatyczny restart usługi

Aby po pobraniu certyfikatów zrestartować usługę (np. Apache), podaj komendę w pliku YAML lub jako argument --restart.

bsapmd --restart "/usr/sbin/service apache2 restart"

Integracja z systemd (Linux)

Przykładowa jednostka systemd i timer dla cyklicznego pobierania certyfikatów.

# /etc/systemd/system/bsapmd.service
[Unit]
Description=SSLBuddy.App Monitoring Downloader
After=network-online.target

[Service]
Type=oneshot
Environment=SSLBUDDY_TOKEN=your_token
ExecStart=/usr/local/bin/bsapmd --restart "/usr/sbin/service apache2 restart"

[Install]
WantedBy=multi-user.target
# /etc/systemd/system/bsapmd.timer
[Unit]
Description=Run bsapmd every 6 hours

[Timer]
OnBootSec=2m
OnUnitActiveSec=6h
Unit=bsapmd.service

[Install]
WantedBy=timers.target
sudo systemctl daemon-reload
sudo systemctl enable --now bsapmd.timer

Przykłady

Argumenty CLI

bsapmd --token "your_token" --cert_id "ID" --cert_path "/etc/ssl/certs/cert1.pem"

Zmienne środowiskowe

export SSLBUDDY_TOKEN="your_token"
export SSLBUDDY_CERT_ID="ID"
export SSLBUDDY_CERT_PATH="/etc/ssl/certs/cert1.pem"
bsapmd

Plik konfiguracyjny (wiele certyfikatów)

token: "your_token"
restart_hook: "/usr/sbin/service apache2 restart"
certificates:
  - id: "ID"
    path: "/etc/ssl/certs/cert1.pem"
  - id: "ID"
    path: "/etc/ssl/certs/cert2.pem"

Pomoc i wersja

bsapmd --help
bsapmd --version