---
title: SOAP client proxy documentation
summary: Entry point for consumed SOAP service proxy documentation.
status: draft
owner: SAIF.Core documentation
last_reviewed: 2026-09-24
---

# SOAP client proxy documentation

This proxy calls the external `clsADServices`† (`ADWebService`) service and is carried inside `SAIF.Services.Web.Proxies`, a packaged proxy library consumed by other libraries in this repository through the `SAIF.SAIFCode.Core` NuGet package. A public authored wrapper, `ActiveDirectoryServiceProxy`, is the only type in the repository that touches the generated (internal) client, but nothing in this repository constructs the wrapper itself.

| Field | Value |
| --- | --- |
| **Proxy name** | `ActiveDirectory` |
| **Mechanism** | Service Reference (svcutil) |
| **Generated namespace** | `SAIF.Services.Web.Proxies.ActiveDirectory` |
| **Generated artifacts** | `Services/SAIF.Services.Web.Proxies/Service References/ActiveDirectory/Reference.cs` |
| **WSDL document** | `Services/SAIF.Services.Web.Proxies/Service References/ActiveDirectory/clsADServices.wsdl` |
| **Proxy base type** | `System.ServiceModel.ClientBase<T>` |
| **Hand-written wrapper** | `SAIF.Services.Web.Proxies.ActiveDirectoryServiceProxy` (`Services/SAIF.Services.Web.Proxies/ActiveDirectoryServiceProxy.cs`) |
| **Consuming project** | `SAIF.Services.Web.Proxies` (`Services/SAIF.Services.Web.Proxies/SAIF.Services.Web.Proxies.csproj`) |
| **Target service** | `clsADServices` |
| **Endpoint source** | Constructor argument (`serviceUrl`), unresolved within this repository |
| **Binding** | `System.ServiceModel.BasicHttpBinding` constructed in code |
| **Operations present** | 20 |
| **Operations called** | 4 |

## Documentation sections

| Section | Description |
| --- | --- |
| [Overview](overview.md) | Which service is called, who consumes the proxy, and capability summary |
| [Architecture](architecture.md) | How the proxy is constructed, configured, and invoked |
| [Contract](contract.md) | The WSDL-declared operations, messages, faults, and binding |
| [Operation map](operation-map.md) | Operations present in the proxy versus operations actually called |
| [Client reference](reference.md) | One section per operation called from repository source |
| [Consumption](consumption.md) | Construction, disposal, resilience, and endpoint configuration |
| [Dependencies](dependencies.md) | Packages, framework components, and the called service |
| [Tech debt](tech-debt.md) | CRITICAL and HIGH severity findings |

<!-- Business rules row dropped: repository source performs field mapping only, no rule of its own. -->

## Called service

| Attribute | Value |
| --- | --- |
| Service name | `clsADServices` |
| Documented by this run | No |
| Service documentation | `clsADServices`† |
| Endpoint address | Configured (unused) design-time value `http://webqa/WebServices/ADWebService/clsADServices.asmx`; the runtime address is supplied by an external caller and is unresolved** |
| Address source | `Services/SAIF.Services.Web.Proxies/ActiveDirectoryServiceProxy.cs:14-16` (constructor parameter, origin not found in this repository) |
| SOAP namespace | `http://tempuri.org/ADWebService/Service1` |

## Related documentation
- [Overview](overview.md)
- [Architecture](architecture.md)
- [Contract](contract.md)
- [Operation map](operation-map.md)
- [Client reference](reference.md)
- [Consumption](consumption.md)
- [Dependencies](dependencies.md)
- [Tech debt](tech-debt.md)

> **Note:** Statements marked with `†` are derived from dependency library
> documentation via the Legends CLI. Statements marked with `**` could not be
> confirmed; treat as unknown until verified.

## Sources
- `Services/SAIF.Services.Web.Proxies/Service References/ActiveDirectory/Reference.cs`
- `Services/SAIF.Services.Web.Proxies/Service References/ActiveDirectory/clsADServices.wsdl`
- `Services/SAIF.Services.Web.Proxies/ActiveDirectoryServiceProxy.cs`
- `Services/SAIF.Services.Web.Proxies/app.config`
- `Services/SAIF.Services.Web.Proxies/SAIF.Services.Web.Proxies.csproj`