Securing the admin Object

3 min read

3 min read

3 min read

2 min read

2 min read

2 min read

2 min read

2 min read

A client that can reach the admin object can use all of its facets: it can read and change every property of the communicator, passwords included, through the Properties facet, and shut down the server through the Process facet. The administrative facility is disabled by default; when you enable it, restrict which clients can reach the admin object and which facets it exposes.

Setting the Ice.Admin.Endpoints property to an endpoint that listens only on the local host restricts access to processes that run on the same host, and any of these processes can reach the admin object:

Properties
Ice.Admin.Endpoints=tcp -h 127.0.0.1

For remote administration, give the object adapter that hosts the admin object SSL endpoints that require a client certificate, for example with IceSSL.VerifyPeer set to 2, its default. Every client with a certificate issued by a certificate authority that the object adapter trusts can then connect, so trust only the certificate authorities that issue certificates to administrative clients.

To accept only some of these clients, IceSSL.TrustOnly.Server.Ice.Admin lists the distinguished names of the certificates that the Ice.Admin object adapter accepts, for example:

Properties
IceSSL.TrustOnly.Server.Ice.Admin=O=Acme\, Inc.,OU=Administrators

When the admin object needs an SSL configuration different from the communicator's, such as a certificate authority trusted only for administrative clients, host it in an object adapter that you create with its own server authentication options, as described in Hosting the admin Object in Your Own Object Adapter. IceSSL.VerifyPeer does not apply to this object adapter, so these options must require a client certificate themselves.

By default, IceGrid enables the administrative facility in the servers that it activates and limits their admin endpoints to the local host; remote administrative clients reach these servers through the IceGrid registry, which forwards their requests through the node.

Filtering the facets removes operations from the admin object for every client that reaches it.