Administration#

I det här kapitlet beskrivs administrativa uppgifter för användare med rollen Administratör. Se kapitel Roller för att läsa mer om rollen.

Viktigt

Se till att du läser informationen i början av det här dokumentet innan du börjar arbeta.

Systemförvaltning#

Information om enheten#

Leverantörs- och produktinformation för en NetHSM kan hämtas på följande sätt.

Exempel

$ nitropy nethsm --host $NETHSM_HOST info

Host:    localhost:8443
Vendor:  Nitrokey GmbH
Product: NetHSM

Uppstartsläge#

NetHSM kan användas i läget Attended Boot och Unattended Boot.

Uppstartsläge	Beskrivning
Deltog i Boot	NetHSM startas upp i ett _Locked_-läge. Vid varje start måste Unlock Passphrase anges, vilken används för att dekryptera User Data. Av säkerhetsskäl rekommenderas detta läge och det är standardläget för ett nyinstallerat system.
Boot utan tillsyn	Systemet startar utan uppsikt utan att du behöver ange Unlock Passphrase i ett _Operational_-tillstånd. Använd detta läge om dina tillgänglighetskrav inte kan uppfyllas med läget Attended Boot.

Varning

Oavsett startläge behåller Unlock Passphrase sin giltighet och krävs för återställning av säkerhetskopior på annan maskinvara. Förvara alltid Unlock Passphrase i säkert förvar.

Det aktuella startläget kan hämtas på följande sätt.

Exempel

$ nitropy nethsm --host $NETHSM_HOST get-config --unattended-boot

Configuration for NetHSM localhost:8443:
   Unattended boot: off

Startläget kan ändras på följande sätt. Vid nästa start kommer NetHSM att bete sig i enlighet med detta.

Argument

Argument	Beskrivning
Status	Aktivera eller inaktivera Unattended Boot. Kan ha värdet `on` eller `off`.

Exempel

$ nitropy nethsm --host $NETHSM_HOST set-unattended-boot on

Updated the unattended boot configuration for NetHSM localhost:8443

Stat#

NetHSM-programvaran har fyra tillstånd: Unprovisioned, Provisioned, Locked och Operational.

Stat	Beskrivning
Oförutsedd	NetHSM utan konfiguration (fabriksinställning)
Förutsatt	NetHSM med konfiguration. Tillståndet Provisioned innebär antingen Operational eller Locked.
Operational	NetHSM med konfiguration och redo att utföra kommandon. Tillståndet Operational förutsätter tillståndet Provisioned.
Lockad	NetHSM med konfiguration men krypterade och oåtkomliga datalager. Nästa steg är vanligtvis att låsa upp systemet. Tillståndet Locked innebär tillståndet Provisioned.

NetHSM:s aktuella tillstånd kan hämtas på följande sätt.

Exempel

$ nitropy nethsm --host $NETHSM_HOST state

NetHSM localhost:8443 is Unprovisioned

En ny NetHSM har tillståndet Unprovisioned och efter provisionering övergår den till tillståndet Operational. Tillhandahållandet av en NetHSM beskrivs i kapitlet Allhandahållande.

En NetHSM i Operational-tillstånd kan låsas igen för att skydda den på följande sätt.

Exempel

$ nitropy nethsm --host $NETHSM_HOST lock

NetHSM localhost:8443 locked

En NetHSM i läget Locked kan låsas upp på följande sätt. Medan NetHSM är i _Locked_-läge är inga andra åtgärder möjliga. Efteråt befinner sig NetHSM i ett _Operational_-läge.

Exempel

$ nitropy nethsm --host $NETHSM_HOST unlock

NetHSM localhost:8443 unlocked

Lås upp lösenordsfrasen#

Passfrasen Unlock Passphrase används för att få fram en Unlock Key om NetHSM är i Locked-tillstånd. Lösenfrasen ställs in initialt under tillhandahållandet av NetHSM.

… varning:: Upplåsningspassfrasen kan inte återställas utan att man känner till det aktuella värdet. Om lösenfrasen för upplåsning förloras kan den inte återställas till ett nytt värde och NetHSM kan inte låsas upp.

Unlock Passphrase kan ställas in på följande sätt.

Valfria alternativ

Alternativ	Beskrivning
`-n`, `--new-passphrase` `TEXT`	Den nya lösenfrasen för upplåsning
`-p`, `--current-passphrase` `TEXT`	Den aktuella lösenfrasen för upplåsning
`-f`, `--force`	Be inte om bekräftelse innan du ändrar lösenfrasen

Exempel

$ nitropy nethsm --host $NETHSM_HOST set-unlock-passphrase

New passphrase:
Repeat for confirmation:
Current passphrase:
Warning: The unlock passphrase cannot be reset without knowing the current value. If the unlock passphrase is lost, neither can it be reset to a new value nor can the NetHSM be unlocked.
Do you want to continue? [y/N]: y
Updated the unlock passphrase for NetHSM localhost:8443

TLS-certifikat#

TLS-certifikatet används för det HTTPS-baserade REST API:et och används därför även av nitropy. Under tillhandahållandet skapas ett självsignerat certifikat. Certifikatet kan ersättas, till exempel med ett signerat certifikat från en certifikatutfärdare (CA). I detta fall måste en Certificate Signing Request (CSR) genereras. Efter signering måste certifikatet importeras till NetHSM.

En ändring är endast nödvändig när certifikatet ska ersättas. En sådan ändring kan vara att ersätta det med ett signerat certifikat från en certifikatutfärdare (CA).

TLS-certifikatet kan hämtas på följande sätt.

Obligatoriska alternativ

Alternativ	Beskrivning
`-a`, `--api`	Ange certifikatet för NetHSM TLS-gränssnittet

Exempel

$ nitropy nethsm --host $NETHSM_HOST get-certificate --api

TLS-certifikatet kan skapas på följande sätt.

Obligatoriska alternativ

Alternativ	Beskrivning
`-t`, `--type` `[RSA\|Curve25519\|EC_P224\|EC_P256\|EC_P384\|EC_P521]`	Typ för den genererade nyckeln
`-l`, `--length` `INTEGER`	Längden på den genererade nyckeln

Exempel

$ nitropy nethsm --host $NETHSM_HOST generate-tls-key -t Curve25519

Key for TLS interface generated on NetHSM localhost:8443

Certificate Signing Request (CSR) för certifikatet kan genereras på följande sätt.

Obligatoriska alternativ

Alternativ	Beskrivning
`-a`, `--api`	Generera en CSR för NetHSM TLS-certifikatet
`--country` `TEXT`	Landets namn
`--state-or-province` `TEXT`	Namnet på delstaten eller provinsen
`--locality` `TEXT`	Namnet på orten
`--organization` `TEXT`	Organisationens namn
`--organizational-unit` `TEXT`	Namnet på organisationsenheten
`--common-name` `TEXT`	Det gemensamma namnet
`--email-address` `TEXT`	E-postadressen

Exempel

$ nitropy nethsm --host $NETHSM_HOST csr --api --country="DE" --state-or-province="Berlin" --locality="Berlin" --organization="Nitrokey" --organizational-unit="" --common-name="Nitrokey" --email-address="info@nitrokey.com"

Certifikatet kan ersättas på följande sätt.

Obligatoriska alternativ

Alternativ	Beskrivning
`-a`, `--api`	Ange certifikatet för NetHSM TLS-gränssnittet

Argument

Argument	Beskrivning
`FILENAME`	Certifikatfil

Exempel

nitropy nethsm --host $NETHSM_HOST set-certificate --api /tmp/nethsm-certificate

Nätverk#

Nätverkskonfigurationen definierar de inställningar som används för Network Port.

Observera

Dessa inställningar konfigurerar inte BMC Network Port.

Nätverkskonfigurationen kan hämtas på följande sätt.

Obligatoriska alternativ

Alternativ	Beskrivning
`--network`	Fråga efter nätverkskonfigurationen

Exempel

$ nitropy nethsm -h $NETHSM_HOST get-config --network

Configuration for NetHSM localhost:8443:
Network:
      IP address:    192.168.1.1
      Netmask:       255.255.255.0
      Gateway:       0.0.0.0

Ställ in nätverkskonfigurationen på följande sätt.

Observera

NetHSM stöder inte DHCP (Dynamic Host Configuration Protocol).

Observera

NetHSM stöder inte IPv6 (Internet Protocol version 6).

Obligatoriska alternativ

Alternativ	Beskrivning
`-a`, `--ip-address`	Den nya IP-adressen
`-n`, `--netmask`	Den nya nätmasken
`-n`, `--netmask`	Den nya gatewayen

Exempel

$ nitropy nethsm -h $NETHSM_HOST set-network-config -a 192.168.1.1 -n 255.255.255.0 -g 0.0.0.0

Updated the network configuration for NetHSM localhost:8443

Tid#

Tidskonfigurationen ställer in systemtiden för NetHSM-programvaran. Det är vanligtvis inte nödvändigt att ställa in systemtiden, eftersom den ställs in under tillhandahållandet.

Tidskonfigurationen kan hämtas på följande sätt.

Obligatoriska alternativ

Alternativ	Beskrivning
`--time`	Fråga efter systemtiden

Exempel

$ nitropy nethsm -host $NETHSM_HOST get-config --time

Configuration for NetHSM localhost:8443:
Time:            2022-08-17 11:40:00+00:00

Ställ in tiden för NetHSM.

Viktigt

Se till att du anger tiden i UTC-tidszon.

Argument

Argument	Beskrivning
`time`	Systemtiden som ska ställas in (Format: YYYYYY-MM-DDTHH:MM:SSZ)

Exempel

$ nitropy nethsm -h $NETHSM_HOST set-time 2022-08-17T11:40:00Z

Updated the system time for NetHSM localhost:8443

Mätvärden#

NetHSM loggar mätvärden för systemparametrar.

Observera

Det här kommandot kräver autentisering av en användare med rollen Metrics. Se kapitel Roller för att läsa mer om rollen.

Se Mätvärden för mer information om varje mätvärde.

Mätvärdena kan hämtas på följande sätt.

Exempel

$ nitropy nethsm -h $NETHSM_HOST metrics

Metric                         Value
----------------------------   --------
client connections             0
established state              6
external.received bytes        989931
external.received packets      13239
external.transmitted bytes     25908953
external.transmitted packets   22037
free chunk count               322
gc compactions                 0
gc major bytes                 21348352
gc major collections           35
gc minor collections           2652
http response 200              28
http response 201              1
http response 204              1
http response 400              1
http response 403              1
http response 404              145
http response 412              1
http response time             0.084998
http response total            178
internal.received bytes        66541
internal.received packets      1130
internal.transmitted bytes     63802
internal.transmitted packets   1133
kv write                       2
log errors                     3
log warnings                   3
maximum allocated space        64528384
maximum releasable bytes       1216
mmapped region count           0
new sleeper size               1
non-mmapped allocated bytes    64528384
sleep queue size               11
syn-rcvd state                 0
timers                         2
total allocated space          43940832
total client                   1
total established              515
total free space               20587552
total sleeper size             12
total syn-rcvd                 514
total timers                   526
uptime                         17626

Loggning#

NetHSM kan logga systemhändelser till den seriella porten eller till en syslog-server i nätverket.

Viktigt

För alla produktionsinstallationer bör NetHSM-loggen övervakas kontinuerligt för att ge omedelbar information om eventuella säkerhetsproblem.

Den seriella konsolen fungerar redan från början av NetHSM-hårdvaran. Den omfattar händelser från NetHSM:s fasta programvara och NetHSM-programvaran.

Inställningarna för den seriella konsolanslutningen är följande.

Inställning av	Värde
Baud-hastighet	115200
Databitar	8
Stoppbitar	1
Paritet	Ingen
Flödeskontroll	Ingen

Konfigurationen av syslog-servern kan hämtas på följande sätt.

Obligatoriska alternativ

Alternativ	Beskrivning
`--network`	Fråga efter loggningskonfigurationen

Exempel

$ nitropy nethsm -h $NETHSM_HOST get-config --logging

Logging:
   IP address:    0.0.0.0
   Port:          514
   Log level:     info

Konfigurationen av syslog-servern kan ställas in på följande sätt.

Obligatoriska alternativ

Alternativ	Beskrivning
`-p`, `--passphrase` `TEXT`	IP-adressen för den nya loggningsdestinationen
`-p`, `--port` `INTEGER`	Port för den nya loggningsdestinationen
`-l`, `--log-level` `[debug\|info\|warning\|error]`	Den nya loggningsnivån

Exempel

$ nitropy nethsm -h $NETHSM_HOST set-logging-config -a 192.168.0.1 -p 514 -l info

Updated the logging configuration for NetHSM localhost:8443

6. Säkerhetskopiera#

NetHSM Användardata kan sparas i en backup-fil. Denna säkerhetskopieringsfil innehåller alla användardata, nämligen Configuration Store, Authentication Store, Domain Key Store och Key Store.

Viktigt

En NetHSM-systemprogramvara i läget Unattended Boot kräver Unlock Passphrase om den återställs på en annan NetHSM-hårdvara. Se kapitel Unlock Passphrase för mer information.

Viktigt

En NetHSM i läget Unattended Boot kommer att vara i samma läge efter en återställning.

Innan en säkerhetskopiering kan påbörjas måste Backup Passphrase ställas in. Backup Passphrase används för att kryptera data i backup-filen.

Varning

Lösenfrasen för säkerhetskopian kan inte återställas om man inte känner till det aktuella värdet. Om lösenfrasen för säkerhetskopian förloras kan den inte återställas till ett nytt värde och de skapade säkerhetskopiorna kan inte heller återställas.

Lösenfrasen för säkerhetskopiering kan ställas in på följande sätt.

Valfria alternativ

Alternativ	Beskrivning
`-n`, `--new-passphrase` `TEXT`	Den nya lösenfrasen för säkerhetskopiering
`-p`, `--current-passphrase` `TEXT`	Den aktuella lösenfrasen för säkerhetskopian (eller en tom sträng om den inte är angiven)
`-f`, `--force`	Be inte om bekräftelse innan du ändrar lösenfrasen

Exempel

$ nitropy nethsm -h $NETHSM_HOST -u admin set-backup-passphrase

New passphrase:
Repeat for confirmation:
Warning: The backup passphrase cannot be reset without knowing the current value. If the backup passphrase is lost, neither can it be reset to a new value nor can the created backups be restored.
Do you want to continue? [y/N]: y
The current backup passphrase (or an empty string if not set) []:
Updated the backup passphrase for NetHSM localhost:8443

Observera

Det här kommandot kräver autentisering av en användare med rollen Backup. Läs mer i kapitel Roller.

Säkerhetskopieringen kan utföras på följande sätt.

Argument

Argument	Beskrivning
`FILENAME`	Säkerhetskopieringsfil

Exempel

$ nitropy nethsm -h $NETHSM_HOST backup /tmp/nethsm-backup

Backup for localhost:8443 written to /tmp/backup

Observera

Den här säkerhetskopian kan endast återställas på en NetHSM-instans som inte har tilldelats någon behörighet.

Återställ#

NetHSM kan återställas från en säkerhetskopia.

Om NetHSM är Unprovisioned kommer den att återställa alla User Data inklusive systemkonfiguration och omstart. Därför kan systemet få andra nätverksinställningar, TLS-certifikat och Unlock Passphrase efteråt.
Om NetHSM är Provisioned kommer den att återställa användare och användarnycklar men inte systemkonfigurationen. I detta fall raderas alla tidigare befintliga användare och användarnycklar. NetHSM avslutas i ett Operational tillstånd.

Återställandet kan göras på följande sätt.

Otillvalsmöjligheter

Alternativ	Beskrivning
`-p`, `--backup-passphrase` `passphrase`	Passfras för säkerhetskopiering
`-t`, `--system-time`	Systemtid som ska ställas in (Format: `YYYY-MM-DDTHH:MM:SSZ`)

Viktigt

Kontrollera att tiden på den lokala datorn är korrekt inställd. Om du vill ställa in en annan tid, ange den manuellt.

Argument

Argument		Beskrivning
`FILENAME` \| Återställ fil

Exempel

$ nitropy nethsm -h $NETHSM_HOST restore /tmp/nethsm-backup

Backup passphrase:
Backup restored on NetHSM localhost:8443

Uppdatering av programvara#

Programuppdateringar kan installeras i en tvåstegsprocess. Först måste uppdateringsbilden laddas upp till en Provisioned NetHSM. NetHSM verifierar bildens äkthet, integritet och versionsnummer. Eventuellt visar NetHSM eventuella versionsanteckningar.

Varning

Dataförlust kan uppstå på grund av installation av en beta-uppdatering! Stabila versioner bör inte orsaka dataförlust. Vi rekommenderar dock att du skapar en säkerhetskopia innan du uppdaterar.

Uppdateringsfilen kan laddas upp på följande sätt.

Argument

Argument	Beskrivning
`FILENAME`	Uppdatera filen

Exempel

$ nitropy nethsm --host $NETHSM_HOST update /tmp/nethsm-update.img.cpio

Image /tmp/nethsm-update.img.cpio uploaded to NetHSM localhost:8443

Därefter kan uppdateringen tillämpas eller avbrytas. Se önskat alternativ nedan. Om NetHSM stängs av före ”commit”-operationen måste uppdateringsfilen laddas upp igen.

Uppdateringen kan tillämpas (committed) enligt följande. Eventuell datamigrering utförs först _efter_ att NetHSM har startat den nya versionen av systemprogramvaran.

Exempel

$ nitropy nethsm --host $NETHSM_HOST commit-update

Update successfully committed on NetHSM localhost:8443

Uppdateringen kan avbrytas på följande sätt.

Exempel

$ nitropy nethsm --host $NETHSM_HOST cancel-update

Update successfully cancelled on NetHSM localhost:8443

Omstart och avstängning#

NetHSM kan startas om och stängas av, antingen på distans eller med omstart- och avstängningsknappen på framsidan av NetHSM-hårdvaran.

Fjärrstart kan initieras på följande sätt.

Exempel

$ nitropy nethsm --host $NETHSM_HOST reboot

NetHSM localhost:8443 will be rebooted.
Do you want to continue? [y/N]: y
NetHSM localhost:8443 is about to reboot

Fjärravstängning kan initieras på följande sätt.

Exempel

$ nitropy nethsm --host $NETHSM_HOST shutdown

NetHSM localhost:8443 will be shutdown.
Do you want to continue? [y/N]: y
NetHSM localhost:8443 is about to shutdown

Återställ till fabriksinställningarna#

En Provisioned NetHSM kan återställas till fabriksinställningarna. I detta fall raderas alla användardata på ett säkert sätt och NetHSM startar i ett Unprovisioned tillstånd. Efteråt kanske du vill provisionera NetHSM.

Återställning till fabriksinställningarna kan utföras på följande sätt.

Exempel

$ nitropy nethsm -h $NETHSM_HOST factory-reset

NetHSM localhost:8443 will be set to factory defaults.
All data will be lost!
Do you want to continue? [y/N]: y
NetHSM localhost:8443 is about to perform a factory reset

Användarhantering#

Roller#

NetHSM gör det möjligt att separera arbetsuppgifter genom att använda olika roller. Varje användarkonto som konfigurerats på NetHSM har tilldelats en av följande roller.

Roll	Beskrivning
Administratör	Ett användarkonto med den här rollen har tillgång till alla operationer som tillhandahålls av NetHSM, med undantag för nyckelanvändning, dvs. signering och dekryptering av meddelanden.
Operator	Ett användarkonto med den här rollen har tillgång till alla nyckelanvändningsoperationer, en delmängd av nyckelhanteringsoperationer med skrivskydd och användarhanteringsoperationer som endast tillåter ändringar för det egna kontot.
Metriker	Ett användarkonto med den här rollen har endast tillgång till skrivskyddade metriker.
Backup	Ett användarkonto med den här rollen har endast tillgång till de åtgärder som krävs för att initiera en säkerhetskopiering av systemet.

Se Taggar för mer detaljerade åtkomstbegränsningar.

Observera

I en framtida version kan ytterligare Roller komma att införas.

Lägg till användare#

Lägg till ett användarkonto till NetHSM. Varje användarkonto har en Role som måste anges. Se kapitel Roller för att lära dig mer om Roller.

Observera

NetHSM tilldelar ett slumpmässigt användar-ID om inget anges.

Ett användarkonto kan läggas till på följande sätt.

Obligatoriska alternativ

Alternativ	Beskrivning
`-n`, `--real-name` `TEXT`	Användarens riktiga namn
`-r`, `--role` `[Administrator\|Operator\|Metrics\|Backup]`	Den nya användarens roll.
`-p`, `--passphrase` `TEXT`	Den nya användarens lösenfras

Valfria alternativ

Alternativ	Beskrivning
`-u`, `--user-id` `TEXT`	Den nya användarens användar-ID

Exempel

$ nitropy nethsm --host $NETHSM_HOST  add-user --real-name "Nitrokey Operator" --role Operator --user-id operator1

Passphrase:
Repeat for confirmation:
User operator1 added to NetHSM localhost:8443

Ta bort användare#

Ta bort ett användarkonto från NetHSM.

Varning

Radering är permanent och kan inte återställas.

Ett användarkonto kan raderas på följande sätt.

Argument

Argument	Beskrivning
`USER_ID`	Användarens användar-id.

Exempel

$ nitropy nethsm --host $NETHSM_HOST delete-user operator1

User operator1 deleted on NetHSM localhost:8443

Lista över användare#

Lista användarna på NetHSM.

Listan kan hämtas på följande sätt.

Valfria alternativ

Alternativ	Beskrivning
`--details`, `--no-details`	Fråga efter användarens riktiga namn och roll

Exempel

$ nitropy nethsm --host $NETHSM_HOST list-users

Users on NetHSM localhost:8843:

User ID        Real name               Role
---------      -----------------       -------------
operator1      Nitrokey Operator       Operator
admin          admin                   Administrator

Användarens lösenfras#

Lösenfrasen för ett användarkonto kan återställas. Lösenfrasen anges för första gången när ett användarkonto läggs till.

Observera

Lösenfraser måste ha >= 10 och <= 200 tecken.

Användarens lösenfras kan ställas in på följande sätt.

Obligatoriska alternativ

Alternativ	Beskrivning
`-u`, `--user-id` `TEXT`	Användarens användar-ID
`-p`, `--passphrase` `TEXT`	Användarens nya lösenfras

Exempel

$ nitropy nethsm --host $NETHSM_HOST set-passphrase --user-id operator1

Passphrase:
Repeat for confirmation:
Updated the passphrase for user operator1 on NetHSM localhost:8443

Taggar för användare#

Taggar kan användas för att ställa in finkorniga åtkomstbegränsningar på tangenter och är en valfri funktion. En eller flera Taggar kan endast tilldelas användarkonton med rollen Operatör. Operatörerna ** kan se alla nycklar, men endast använda dem med minst en motsvarande Tag. En nyckel kan inte ändras av en Operatör användare.

Om du vill veta hur du använder Tags på nycklar, se Tags för nycklar.

En Tag kan läggas till enligt följande.

Argument

Argument	Beskrivning
`USER_ID`	Användar-ID som taggen ska sättas på.
`TAG`	Den tagg som ska anges för användar-ID.

Exempel

nitropy nethsm --host $NETHSM_HOST add-operator-tag operator1 berlin

Added tag berlin for user operator1 on the NetHSM localhost:8443

Tag kan raderas på följande sätt.

Argument

Argument	Beskrivning
`USER_ID`	Användar-ID som taggen ska sättas på.
`TAG`	Den tagg som ska anges för användar-ID.

Exempel

nitropy nethsm --host $NETHSM_HOST delete-operator-tag operator1 berlin

Deleted tag berlin for user operator1 on the NetHSM localhost:8443