# Web access administration (IRPCWebAccessAdmin)

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Administration API](https://developer.m-files.com/APIs/gRPC-API/admin/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/

Sets up M-Files Web in Internet Information Services (IIS) on the server computer.

NOTE: Do NOT change the layout of methods and their parameters
so that older clients could utilize this interface against a newer
server.

Before client can use this interface, login is needed to the server.
This can be achieved through the IRPCLogin interface.

- **gRPC service:** `MFiles.IRPCWebAccessAdmin`
- **Book and level:** [Administration API](https://developer.m-files.com/APIs/gRPC-API/admin/index.md), specialized
- **Methods:** 7
- **Proto file:** [`mfiles/IRPCWebAccessAdmin.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/IRPCWebAccessAdmin.proto)

<a id="overview"></a>

## Overview

**For M-Files components only.** M-Files Admin uses this service in its M-Files Web
configuration dialog to check the IIS prerequisites and to create or reuse an IIS web site or
virtual directory for M-Files Web. Applications should not call it.

**Sessions and rights.** Every method requires the system administrator server role (server
right `edit_web_access_settings` in [ServerAccess](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.ServerAccess/index.md)); a server-level
session is enough. Other callers get "Access denied. You do not have the server-level access
rights required by this operation.".

Typical order in M-Files Admin:
[CheckCommonRequirements](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/CheckCommonRequirements/index.md) or
[CheckCommonRequirementsForWeb](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/CheckCommonRequirementsForWeb/index.md),
then [QueryADSIObjects](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/QueryADSIObjects/index.md) to list the IIS web
sites, then [UseExistingWebSite](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/UseExistingWebSite/index.md),
[CreateWebSite](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/CreateWebSite/index.md) or
[CreateVirtualDirectory](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/CreateVirtualDirectory/index.md).
The IIS objects are addressed with ADSI paths such as `IIS://localhost/w3svc/2/ROOT`.

<a id="methods"></a>

## Methods

| Method | Summary | Facts |
|---|---|---|
| [CheckCommonRequirements](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/CheckCommonRequirements/index.md) | Checks that IIS and ASP.NET are installed and configured as M-Files Web needs. | `internal: not for applications` `admin` `session` `idempotent` |
| [CheckCommonRequirementsForWeb](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/CheckCommonRequirementsForWeb/index.md) | Checks the IIS prerequisites of the new M-Files Web, including the URL Rewrite and Application Request Routing modules. | `internal: not for applications` `admin` `session` `idempotent` |
| [CreateVirtualDirectory](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/CreateVirtualDirectory/index.md) | Creates an IIS virtual directory for M-Files Web under an existing web site. | `internal: not for applications` `admin` `session` |
| [CreateWebSite](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/CreateWebSite/index.md) | Creates a new IIS web site for M-Files Web. | `internal: not for applications` `admin` `session` |
| [NotifyHttpGrpcService](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/NotifyHttpGrpcService/index.md) | Tells the server's HTTP-to-gRPC gateway that web client settings (such as add-in settings or the default web client) have changed. | `internal: not for applications` `admin` `session` `idempotent` |
| [QueryADSIObjects](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/QueryADSIObjects/index.md) | Lists the child objects of an IIS (ADSI) path on the server computer, for example its web sites. | `internal: not for applications` `admin` `session` `idempotent` |
| [UseExistingWebSite](https://developer.m-files.com/APIs/gRPC-API/Reference/MFiles.IRPCWebAccessAdmin/UseExistingWebSite/index.md) | Configures an existing IIS web site for M-Files Web. | `internal: not for applications` `admin` `session` `idempotent` |