---
title: "Securing the admin Object"
url: https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Securing the admin Object

This page is written for C++, C#, Java, MATLAB, PHP, Python, Ruby, and Swift.

Parts of this page are for some programming languages only, and name them. For one language's text alone, see [C++](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets/csharp.md), [Java](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets/java.md), [MATLAB](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets/matlab.md), [PHP](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets/php.md), [Python](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets/python.md), [Ruby](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets/ruby.md), and [Swift](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets/swift.md).

A client that can reach the [admin object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/admin-object.md) 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](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object.md); when you enable it, restrict which clients can reach the admin object and which facets it exposes.

## Restricting Access

Setting the [Ice.Admin.Endpoints](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties.md) 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:

```config
Ice.Admin.Endpoints=tcp -h 127.0.0.1
```

For remote administration, give the object adapter that hosts the admin object [SSL](https://docs.zeroc.com/ice/3.8/runtime/ssl-transport.md) endpoints that require a client certificate, for example with [IceSSL.VerifyPeer](https://docs.zeroc.com/ice/3.8/property-reference/icessl-properties.md#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](https://docs.zeroc.com/ice/3.8/property-reference/icessl-properties.md#icessl.trustonly.server.adaptername) lists the distinguished names of the certificates that the `Ice.Admin` object adapter accepts, for example:

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

> **C++, C#, and Java**
>
> 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](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object.md#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](https://docs.zeroc.com/ice/3.8/services/icegrid.md) enables the administrative facility in the servers that it activates and [limits their admin endpoints to the local host](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-and-the-administrative-facility.md#ice.admin.endpoints-for-servers); remote administrative clients reach these servers through the IceGrid registry, which forwards their requests through the node.

## Restricting the Facets

[Filtering the facets](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/filtering-administrative-facets.md) removes operations from the admin object for every client that reaches it.

## See Also

- [Creating the admin Object](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/creating-the-admin-object.md)
- [Filtering Administrative Facets](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/filtering-administrative-facets.md)
- [IceGrid and the Administrative Facility](https://docs.zeroc.com/ice/3.8/services/icegrid/icegrid-and-the-administrative-facility.md)
- [SSL Transport](https://docs.zeroc.com/ice/3.8/runtime/ssl-transport.md)
- [Ice.Admin.\*](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties.md)
