Editing OpenSimulator Internals/Code Map/ROBUST/GatekeeperService (section)

=== Constructor and Config Loading ===

 GatekeeperService(IConfigSource config, ISimulationService simService)

[GatekeeperService] section is required -- throws if absent.

All static fields are initialized once (m_Initialized flag). Subsequent instantiations are no-ops.

Services loaded from [GatekeeperService]:

{| class="wikitable"
! Key !! Interface !! Required
|-
| GridService || IGridService || Yes -- throws if empty
|-
| PresenceService || IPresenceService || Yes -- throws if empty
|-
| SimulationService || ISimulationService || Yes -- throws if null after loading
|-
| UserAccountService || IUserAccountService || No
|-
| UserAgentService || IUserAgentService || No
|-
| GridUserService || IGridUserService || No
|-
| BansService || IBansService || No
|}

simService argument takes precedence over SimulationService config key if non-null.

Additional config:

{| class="wikitable"
! Section !! Key !! Default !! Notes
|-
| [GatekeeperService] || ScopeID || UUID.Zero || Grid scope filter
|-
| [GatekeeperService] || AllowTeleportsToAnyRegion || true || If false, all inbound TPs go to the default HG region
|-
| [Const]/[Startup]/[Hypergrid]/[GatekeeperService] || GatekeeperURI || (none) || External URL of this gatekeeper; also tries ExternalName
|-
| [Const]/[Startup]/[Hypergrid]/[GatekeeperService] || GatekeeperURIAlias || (none) || Comma-separated list of alternate hostnames accepted as this grid
|-
| [GatekeeperService] || ForeignAgentsAllowed || true || Whether visitors from other grids are permitted
|-
| [GatekeeperService] || AllowExcept || (none) || Comma-separated HomeURIs excluded from ForeignAgentsAllowed=true
|-
| [GatekeeperService] || DisallowExcept || (none) || Comma-separated HomeURIs excluded from ForeignAgentsAllowed=false
|-
| [AccessControl]/[GatekeeperService] || AllowedClients || (none) || Regex matched against viewer string
|-
| [AccessControl]/[GatekeeperService] || DeniedClients || (none) || Regex matched against viewer string
|-
| [AccessControl]/[GatekeeperService] || DeniedMacs || (none) || Case-insensitive substring match against MAC
|-
| [AccessControl]/[GatekeeperService] || DeniedID0s || (none) || Case-insensitive substring match against id0
|-
| [PresenceService] || AllowDuplicatePresences || false || If false, kick existing session on duplicate login
|-
| [Messaging] || MessageKey || (none) || Auth key for InstantMessage service
|}

GatekeeperURI is resolved at startup via OSHHTPHost. Throws if the hostname cannot be resolved or is invalid.

GatekeeperURIAlias entries are parsed but not resolved (IsValidHost only, not IsResolvedHost) -- allows aliases that may not be locally resolvable.

AllowedClients and DeniedClients regex compilation failures are caught and logged; the regex is set to null (check skipped).

----