Replaces a trust's keys at the next kvno. The incoming version it
replaces is KEPT and still opens tickets for graceSeconds() — the
partner goes on sealing with it until its own side changes — while
nothing new is issued under it; the outgoing key is used from the next
referral. One previous incoming version is kept: a second rotation
within the grace ends the first one's.
With mirror and a trust-realm partner, the partner realm's record is
rotated in the same act with the same keys the other way round, so the
two realms never disagree; without it, the partner's administrator
gives their side the same password (or the keys shown once).
Parameters
partner: string
the partner Kerberos realm
input: any
password or generate: true; side (both — the
default — incoming or outgoing, of the sides held); mirror
Replaces a trust's keys at the next kvno. The incoming version it replaces is KEPT and still opens tickets for
graceSeconds()— the partner goes on sealing with it until its own side changes — while nothing new is issued under it; the outgoing key is used from the next referral. One previous incoming version is kept: a second rotation within the grace ends the first one's.With
mirrorand a trust-realm partner, the partner realm's record is rotated in the same act with the same keys the other way round, so the two realms never disagree; without it, the partner's administrator gives their side the same password (or the keys shown once).