features/recognition/
Every setting of features/recognition/settings.yml and its per-provider settings.
features/recognition/settings.yml holds recognition's shared settings. Recognition explains what it does and its risks.
settings.yml
Warning
Takestrue or false
Defaultfalse
Affectswhether players are recognised, for every provider that does not set its own value
Read Recognition before turning it on.
Advanced
Takesa positive duration
Default"12h"
Affectshow long after logging in a player can still be recognised
After that, the player logs in as usual.
Advanced
Takesa positive duration
Default"10m"
Affectshow long Identica remembers that a connection was recognised
Warning
Takesa list containing any of "USERNAME", "IP", "VIRTUAL_HOST"
Default["USERNAME", "IP", "VIRTUAL_HOST"]
Affectswhat a reconnecting player must match, for every provider that does not set its own signals
USERNAME is the username, IP the address, VIRTUAL_HOST the hostname the player joined through. With an empty list, and no signals on the provider either, there is nothing to compare by and nobody is recognised.
Warning
Takestrue or false
Defaulttrue
Affectswhether players from the addresses in entries are never recognised
Warning
Takesa list of exact IP literals or IPv4/IPv6 CIDR ranges
Default["127.0.0.1", "::1", "10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"]
Affectsthe addresses players are never recognised from
The defaults cover loopback and private addresses, which Identica sees instead of the players' real ones behind a misconfigured proxy.
Advanced
Takesa string
Default"identica:session-recognition:snapshot"
Affectsthe name under which proxies share what they remember about logged-in players
Advanced
Takesa string
Default"identica:recognized-connection"
Affectsthe name under which proxies share which connections were recognised
Per provider
Under features.recognition of a provider's entry in providers/providers.yml:
providers:
- id: "credential"
features:
recognition:
enabled: true
signals:
- USERNAME
- IPWarning
Takestrue or false
Defaultabsent
Affectswhether this provider's players are recognised
When absent, the shared enabled applies.
Warning
Takesa list containing any of "USERNAME", "IP", "VIRTUAL_HOST"
Defaultabsent
Affectswhat this provider's reconnecting players must match
When absent or empty, defaultSignals applies.
Advanced
Takestrue or false
Defaultfalse
Affectswhether this provider's players are recognised from the addresses in eligibility.untrustedIps.entries as well