WebSocket <webSocket>

아티클
07/19/2023

개요

요소는 <webSocket> WebSocket 프로토콜을 통해 통신하는 서버 애플리케이션 작성을 지원하기 위해 ASP.NET 4.5와 함께 WebSocketModule 모듈을 사용하도록 지정합니다. WebSocket을 사용하면 바이트 스트림이 아닌 메시지 스트림을 사용하여 단일 TCP 연결을 통해 전체 이중 통신을 제공할 수 있습니다. 이렇게 하면 클라우드 배포에서 데이터 원본에 비동기적으로 쉽게 연결할 수 있습니다.

호환성

버전	참고
IIS 10.0	`<webSocket>` 요소가 IIS 10.0에서 수정되지 않았습니다.
IIS 8.5	`<webSocket>` 요소가 IIS 8.5에서 수정되지 않았습니다.
IIS 8.0	요소는 `<webSocket>` IIS 8.0에서 도입되었습니다.
IIS 7.5	해당 없음
IIS 7.0	해당 없음
IIS 6.0	해당 없음

설치 프로그램

Windows Server 2012 또는 Windows Server 2012 R2

작업 표시줄에서 서버 관리자를 클릭합니다.
서버 관리자관리 메뉴를 클릭한 다음 역할 및 기능 추가를 클릭합니다.
역할 및 기능 추가 마법사에서 다음을 클릭합니다. 설치 유형을 선택하고 다음을 클릭합니다. 대상 서버를 선택하고 다음을 클릭합니다.
서버 역할 페이지에서 웹 서버(IIS)를 확장하고, 웹 서버를 확장하고, 애플리케이션 개발을 확장한 다음, WebSocket 프로토콜을 선택합니다. 다음을 클릭합니다.
.
기능 선택 페이지에서 다음을 클릭합니다.
설치 선택 확인 페이지에서 설치를 클릭합니다.
Results(결과) 페이지에서 Close(닫기)를 클릭합니다.

Windows 8 또는 Windows 8.1

시작 화면에서 포인터를 왼쪽 아래 모서리로 이동하고 시작 단추를 마우스 오른쪽 단추로 클릭한 다음 제어판 클릭합니다. - 제어판프로그램 및 기능을 클릭한 다음 Windows 기능 켜기 또는 끄기를 클릭합니다.
인터넷 정보 서비스를 확장하고 World Wide Web Services를 확장하고 애플리케이션 개발 기능을 확장한 다음 WebSocket 프로토콜을 선택합니다.
확인을 클릭합니다.
닫기를 클릭합니다.

방법

IWebSocketContext API를 사용하는 방법

개발자는 IWebSocketContext API를 사용하여 클라이언트와 서버 간에 양방향 및 완전 이중 통신을 구현하고 바이트 대신 메시지 스트림을 보내는 애플리케이션을 만들 수 있습니다. IWebSocketContext API는 WebSocket 데이터를 읽고 쓰는 데 필요한 API를 노출합니다.

들어오는 요청이 WebSocket 요청으로 수락되고 이후에 업그레이드되는 경우 처리기는 응답 상태 101로 설정해야 합니다. 클라이언트에 101 응답을 보내는 데 필요한 작업을 수행하기 위해 IIS WebSocket 모듈을 트리거하는 IHttpResponse-Flush>를 시작해야 합니다.

응답이 전송되면 처리기는 IHttpContext3의 GetNamedContext API를 통해 IWebSocketContext에 대한 포인터를 가져올 수 있습니다.

자세한 내용은 IWebSocketContext 인터페이스를 참조하세요.

webSocket을 구성하는 방법

IIS(인터넷 정보 서비스) 관리자를 엽니다.
- Windows Server 2012 이상을 사용하는 경우:
  - 작업 표시줄에서 서버 관리자 클릭하고 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
- Windows 8 이상을 사용하는 경우:
  - Windows 키를 누른 채로 문자 X를 누른 다음 제어판 클릭합니다.
  - 관리 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 두 번 클릭합니다.
연결 창에서 서버 이름을 선택하여 서버에 WebSocket을 구성하거나 사이트를 확장한 다음 사이트에 대해 WebSocket을 구성할 사이트를 선택하거나 사이트를 확장한 다음 애플리케이션에 대해 WebSocket을 구성하는 애플리케이션을 선택합니다.
홈 창에서 구성 편집기 기능을 두 번 클릭합니다.
사이트 또는 애플리케이션의 경우 원본 텍스트 상자에서 web.config 또는 applicationHost.config 선택합니다.
섹션 텍스트 상자에서 system.webServer/webSocket을 선택합니다.
webSocket을 사용하도록 설정하려면 True로 설정하고, WebSocket을 사용하지 않도록 설정하려면 False로 설정합니다enabled. pingInterval 및 receiveBufferLimit를 원하는 값으로 설정합니다.
작업 창에서 적용을 클릭합니다.

구성

요소는 <webSocket> 서버, 사이트 또는 애플리케이션 수준에서 구성됩니다.

특성

attribute	Description
`enabled`	선택적 부울 특성입니다. 서버 애플리케이션이 WebSocket 프로토콜을 통해 통신할 수 있도록 합니다. 기본값은 `true`입니다.
`pingInterval`	선택적 timeSpan 특성입니다. WebSocket 연결을 통해 ping이 전송되는 간격입니다. 기본값은 `00:00:00`입니다.
`receiveBufferLimit`	선택적 uint 특성입니다. WebSocket 연결에 대한 수신 버퍼의 최대 크기입니다. 기본값은 `4194304`입니다.

자식 요소

없음

구성 샘플

다음 샘플에서는 webSocket> 요소를 표시합니다<.

<system.webServer>
   <webSocket
      enabled="true" 
      receiveBufferLimit="4194304"
      pingInterval="00:01:00">
   </webSocket>
</system.webServer>

샘플 코드

다음 샘플 코드는 사이트에 대한 webSocket>을 구성합니다<.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/webSocket /enabled:"True" /receiveBufferLimit:"4194304" /pingInterval:"00:00:10"  /commit:apphost

참고

AppCmd.exe 사용하여 이러한 설정을 구성할 때 commit 매개 변수 apphost 를 로 설정해야 합니다. 그러면 구성 설정이 ApplicationHost.config 파일의 적절한 위치 섹션에 커밋됩니다.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample {

    private static void Main() {
        
        using(ServerManager serverManager = new ServerManager()) { 
            Configuration config = serverManager.GetApplicationHostConfiguration();
            
            ConfigurationSection webSocketSection = config.GetSection("system.webServer/webSocket", "Default Web Site");
            webSocketSection["enabled"] = true;
            webSocketSection["receiveBufferLimit"] = 4194304;
            webSocketSection["pingInterval"] = TimeSpan.Parse("00:00:10");
            
            serverManager.CommitChanges();
        }
    }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration
Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim webSocketSection As ConfigurationSection = config.GetSection("system.webServer/webSocket", "Default Web Site")
      webSocketSection("enabled") = true
      webSocketSection("receiveBufferLimit") = 4194304
      webSocketSection("pingInterval") = TimeSpan.Parse("00:00:10")
      serverManager.CommitChanges
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var webSocketSection = adminManager.GetAdminSection("system.webServer/webSocket", "MACHINE/WEBROOT/APPHOST/Default Web Site");
webSocketSection.Properties.Item("enabled").Value = true;
webSocketSection.Properties.Item("receiveBufferLimit").Value = 4194304;
webSocketSection.Properties.Item("pingInterval").Value = "00:00:10";

adminManager.CommitChanges();

VBScript

Set adminManager = CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set webSocketSection = adminManager.GetAdminSection("system.webServer/webSocket", "MACHINE/WEBROOT/APPHOST/Default Web Site")
webSocketSection.Properties.Item("enabled").Value = true
webSocketSection.Properties.Item("receiveBufferLimit").Value = 4194303
webSocketSection.Properties.Item("pingInterval").Value = "00:00:20"

adminManager.CommitChanges()

PowerShell

Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/webSocket" -name "enabled" -value "True"
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/webSocket" -name "receiveBufferLimit" -value 4194303
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/webSocket" -name "pingInterval" -value "00:00:20"

다음을 통해 공유