比尔云BierYun--阿里云最新优惠活动
阿里云优惠码丨阿里云代金券

IIS集中化管理与编程REST API

IIS集中化管理与编程REST API

目录

一、       简介

二、       安装

三、       IIS Administration配置文件

四、       Web UI管理界面

五、       IIS Administration API

一、简介

Microsoft IIS Administration 微软提供,管理IIS配置的REST API 和集中化IIS管理WEB UI。

l  支持绝大部分IIS配置项管理

l  支持管理远程IIS,实现集中化IIS配置管理。

l  支持REST API,方便集成到自研系统。

l  支持IIS配置访问安全性设置

Github:https://github.com/Microsoft/IIS.Administration

微软官网使用文档:https://docs.microsoft.com/en-us/IIS-Administration/

二、安装

下载:https://docs.microsoft.com/en-us/IIS-Administration/getting-started

环境要求:

l  操作系统Windows7版本及以上版本

l  IIS Administration API 依赖.NET Core,在安装IIS Administration安装包时,会按需自动安装

安装完后:

Windows服务名:Microsoft IIS Administration

Microsoft IIS Administration API地址:https://localhost:55539 (可以使用IP地址访问,当时会遇到权限问题,修改权限的方法在下面“修改配置文件”中介绍)

Web UI管理地址:https://manage.iis.net/get

获取AccessToken

进入https://localhost:55539/connect,创建一个Access Key

拿到accesstoken后

l  通过地址:https://localhost:55539/connect 进入api展示界面(https://localhost:55539/#/api),查看可在自己的程序中通过rest api 访问iis信息

l  通过地址:https://manage.iis.net/connect 进入UI管理界面

三、IIS Administration配置文件

1)  配置文件路径:%SystemDrive%\Program Files\IIS Administration\<version>\Microsoft.IIS.Administration\config\**

2)  修改配置文件后需要重启windows服务(Microsoft IIS Administration)

3)  appsettings.json 配置:安全性、日志、audit(审计)、cors(跨域)等

4)  modules.json配置:启用或禁用IIS配置模块

配置修改示例

示例一、访问https://远程IP地址:55539/connect ,出现windows登录验证框

修改点:修改appsettings.json,将”require_windows_authentication”设置为 false

示例二、编码访问IIS Administration REST API 报401没有权限访问

修改点:修改appsettings.json,”access_policy” -> “api” ->”users”: “administrators”修改为:”users”: “Everyone”

appsettings.json修改后类似如下:(默认会将执行安装包的角色加入到安全设置中)

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

“security”: {

    “require_windows_authentication”: false,    // 默认为true

    “users”: {

      “administrators”: [

        ……

      ],

      “owners”: [

        ……

      ]

    },

    “access_policy”: {

      “api”: {

        “users”: “Everyone”,    // 默认为执行安装包角色

        “access_key”: true

      },

      “api_keys”: {

        “users”: “administrators”,

        “access_key”: false

      },

      “system”: {

        “users”: “owners”,

        “access_key”: true

      }

    }

  }

四、Web UI管理界面

前面介绍中拿到Access Token后,进入 https://manage.iis.net 管理界面

支持远程IIS管理

IIS服务器的系统资源监控

IIS根节点配置管理

IIS上的站点信息

IIS上的特定站点配置管理

包括:绑定信息、应用程序池、虚拟目录下的应用程序、身份验证、默认文档、目录浏览、IP限制、日志、MIME类型、监控、模块、响应压缩、请求筛选、HTTP响应标头、请求跟踪、静态缓存、HTTP重定向等

五、IIS Administration API

前面介绍中拿到Access Token后,进入 https://localhost:55539/#/api

METHOD      DESCRIPTION

GET         Retrieves the specified resource

POST        Creates a resource

PATCH       Updates the specified resource

DELETE      Deletes the specified resource

HEAD        Similar to get except only returns HTTP headers

示例

https://docs.microsoft.com/en-us/IIS-Administration/api/crud

代码示例RestSharp

01

02

03

04

05

06

07

08

09

var client = new RestClient(iisAdminBaseUrl);

ServicePointManager.ServerCertificateValidationCallback +=

(sender, certificate, chain, sslPolicyErrors) => true;

var request = new RestRequest(“/api/webserver/websites”, Method.GET);

request.AddHeader(“Access-Token”, $”Bearer {token}”);

request.AddHeader(“Accept”, “application/hal+json”);

IRestResponse response = client.Execute(request);

if (response.IsSuccessful)

{ …… }

代码示例HttpClient

01

02

03

04

05

06

07

08

09

10

11

12

13

14

15

16

var apiClient = new HttpClient(new HttpClientHandler()

{

UseDefaultCredentials = true,

ServerCertificateCustomValidationCallback = (message, cert, chain, error) => true

}, true);

// Set access token for every request

apiClient.DefaultRequestHeaders.Add(“Access-Token”, “Bearer {token}”);

// Request HAL (_links)

apiClient.DefaultRequestHeaders.Add(“Accept”, “application/hal+json”);

var res = await apiClient.GetAsync(“https://localhost:55539/api/webserver/websites”);

if (res.StatusCode != HttpStatusCode.OK) {

  HandleError(res);

  return;

}

JArray sites = JObject.Parse(res.Content.ReadAsStringAsync().Result).Value<JArray>(“websites”);

===========================================

over,谢谢阅读,若对你有帮助,请帮推荐下。

原文地址https://www.cnblogs.com/heyuquan/p/iis-admin-and-develop.html

未经允许不得转载:阿里云代金券 » IIS集中化管理与编程REST API

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址

强烈推荐

高性能SSD云服务器ECS抗攻击,高可用云数据库RDS