Konfiguration
Ein zusammengeführter Konfigurationsbaum beantwortet was ist diese Einstellung jetzt. Die Frage, die dich tatsächlich hierher bringt, ist warum ist sie nicht das, was ich geschrieben habe — und dafür braucht es die Schicht zusätzlich zum Wert.
| Spalte | Bedeutung |
|---|---|
| key | Vollständiger Punktpfad, z. B. actor-ts.cluster.seed-nodes |
| value | Der effektive Wert nach dem Merge |
| from | Welche Schicht gewonnen hat: reference.conf (actor-ts), reference.conf, application.conf, profile, secrets.conf oder code |
Ein Hover auf die Zeile zeigt die ganze Geschichte: die Schicht, ob sie eine tiefere verdrängt hat, aus welchen Umgebungsvariablen der Wert stammt und ob er für die Leitung gekürzt wurde.
Changed from defaults only blendet alles aus, was noch auf seinem eingebauten Wert steht — üblicherweise alles bis auf eine Handvoll Keys. Bleibt die Tabelle dann leer, sagt das Panel es: dass nichts die Defaults überschreibt, ist eine Antwort für sich — und eine andere als „kein Key passt zu diesem Filter”.
Die sechs Schichten
Abschnitt betitelt „Die sechs Schichten“Präzedenz, höchste zuerst:
code— was du alsActorSystemOptions.configübergeben hast.secrets.conf— die Secrets-Datei, überwithSecretsFile, dannACTOR_TS_SECRETS_CONF, dann./secrets.conf, samt ihrem aktiven Profil. Jeder Wert, den sie gesetzt hat, kommt zurückgehalten an.profile— der Blockprofiles.<name>derapplication.conffür das aktive Profil, gewählt überwithProfile, dannACTOR_TS_PROFILE.application.conf— aufgelöst überconfigFile, dannACTOR_TS_CONFIG, dann./application.conf.reference.conf— die eigene des Projekts, überwithReferenceConfigFile, dannACTOR_TS_REFERENCE_CONFIG, dann./reference.conf, samt ihrem aktiven Profil.reference.conf (actor-ts)— mit dem Paket ausgeliefert.
Der Loader führt acht Schichten zusammen, das Panel nennt sechs: ein Key,
den das aktive Profil der Secrets-Datei gesetzt hat, erscheint als
secrets.conf, denn das Wichtige an ihm ist, dass er geheim ist, und einer
aus dem Profil der reference.conf des Projekts als reference.conf.
Changed from defaults only behandelt alle fünf Schichten über
reference.conf (actor-ts) als Änderungen.
Das Panel nennt, woher application.conf gelesen wurde — oder dass keine
gefunden wurde. Diese Unterscheidung zählt mehr, als sie aussieht: meine
Datei wird ignoriert und meine Datei sagt etwas anderes sind
verschiedene Probleme, und der Pfad ist es, was sie trennt. Ist ein
Profil aktiv, nennt es auch das, und ebenso die Secrets-Datei, die
reference.conf des Projekts und die .env-Datei, deren Variablen
Substitutionen beantwortet haben, wenn eine gelesen wurde.
Geheimnisse
Abschnitt betitelt „Geheimnisse“Ein Wert, dessen Key ein Geheimnis benennt — wenn irgendein ganzes Wort
davon oder eines Keys darüber password, passphrase, passwd, pass,
secret, token, key, credential, auth oder authorization lautet,
egal an welcher Stelle im Namen das Wort steht — wird durch <redacted>
ersetzt, bevor er den Prozess verlässt. Nach Key statt nach Wert, denn ein
Passwort, das zufällig gewöhnlich aussieht, ist immer noch ein Passwort, und
der Key ist es, der es benennt. Ein Name wird an jedem Zeichen, das weder
Buchstabe noch Ziffer ist, an jedem camelCase-Höcker und vor einer Ziffer
nach einem Buchstaben in Wörter zerlegt, und diese Wörter zählen auch an ein
anderes geklebt (pgpassword, clientsecret) — bis auf key, pass und
auth, von denen apikey, accesskey, secretkey und privatekey
namentlich gelesen werden, ebenso pwd neben einem anderen Wort des
Key-Pfads, mysql-pwd oder db.pwd.
api-key, password2, auth-header und eine eigene token-bucket-size
werden also zurückgehalten,
passivation-idle und keyspace dagegen gezeigt; die Keys, die
reference.conf mitbringt und die nur wie Zugangsdaten klingen, etwa
cache.redis.key-prefix, sind namentlich ausgenommen, und ein Boolean wird
nie zurückgehalten, wie er auch heißt. Die Felder eines
Objekts in einer Liste werden genauso gelesen, denn eine Liste ist ein
einziger Key: in upstreams = [ { host = "db-1", password = "…" } ]
kommt nur password zurückgehalten an.
Ein Wert, den eine Umgebungsvariable geliefert hat, wird zurückgehalten, wenn
ihr Name nach derselben Regel Zugangsdaten benennt, egal wie sein Key heißt:
my-app.dsn = ${DB_PASSWORD}, ein Key, der darauf verweist, und eine
Zeichenkette, die daraus gebaut ist, kommen alle zurückgehalten an. Jeder
Eintrag trägt die Namen der Variablen hinter seinem Wert, ob zurückgehalten
oder nicht, und der Tooltip der Zeile zeigt sie.
Ein Wert, den die Secrets-Datei gesetzt hat, wird zurückgehalten, egal wie
sein Key heißt — auch wenn eine höhere Schicht den Key überschreibt. Beides
gilt in einem Worker eines WorkerMesh, dessen ganze Konfiguration als
Code-Overrides ankommt.
Eine URL ist das Einzige, was nach dem Wert maskiert wird, unter jedem Key:
Die Userinfo jedes scheme://user:password@host in einem Wert — und in
jedem Element einer Liste — wird durch *** ersetzt, bevor der Wert für
die Leitung gekürzt wird, damit eine Kürzung nie ein halbes Passwort
zurücklässt. redis://default:s3cret@redis.example:6379/0 kommt als
redis://***@redis.example:6379/0 an, mit Host, Port, Pfad und Query wie
geschrieben. Die Userinfo reicht bis zum letzten @ vor dem nächsten ://,
also wird ein Passwort mit einem rohen /, ? oder # darin ganz maskiert,
und ebenso alles vor einem @ weiter hinten, in einem Pfad oder einer Query
einer URL ohne Zugangsdaten. Was keine der vier sieht — die Key-Regel, die
Variablen-Regel, die Secrets-Datei, die URL-Maske —, wird unverändert
gezeigt: ein ausgeschriebenes nacktes Passwort unter einem Key, der keines
benennt, außerhalb der Secrets-Datei; Zugangsdaten im Query-String
(?authToken=…); die Form Server=…;Password=… von SQL Server; und die
schemalose Server-Liste user:password@host von Memcached.
Das ist bewusst ein grobes Werkzeug. Ein Konfigurationsbaum verrät auch geschwärzt eine Menge über ein Deployment — Hosts, Ports, Seed-Nodes, Speicherpfade — also schalte das Panel ab, wo das zählt:
const devtoolsOptions = DevToolsOptions.create() .withPanels({ config: false });