---
title: "Securing the admin Object"
url: https://docs.zeroc.com/ice/3.8/administration/administrative-facility/security-considerations-for-administrative-facets
language: ruby
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

Programming language: Ruby. Other languages: [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), [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/ruby.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/ruby.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/ruby.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/ruby.md) endpoints that require a client certificate, for example with [IceSSL.VerifyPeer](https://docs.zeroc.com/ice/3.8/property-reference/icessl-properties/ruby.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/ruby.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
```

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/ruby.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/ruby.md)
- [Filtering Administrative Facets](https://docs.zeroc.com/ice/3.8/administration/administrative-facility/filtering-administrative-facets/ruby.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/ruby.md)
- [Ice.Admin.\*](https://docs.zeroc.com/ice/3.8/property-reference/ice-admin-properties/ruby.md)
