chrome.networking.onc

설명

chrome.networking.onc API는 네트워크 연결 (모바일 데이터, 이더넷, VPN 또는 Wi-Fi)을 구성하는 데 사용됩니다. 이 API는 자동 실행되는 ChromeOS 키오스크 세션에서 사용할 수 있습니다.

네트워크 연결 구성은 개방형 네트워크 구성 (ONC) 사양에 따라 지정됩니다.

NOTE: 대부분의 사전 속성과 enum 값은 JavaScript lowerCamelCase 규칙 대신 ONC 사양과 일치하도록 UpperCamelCase를 사용합니다.

권한

networking.onc

가용성

Chrome 59 이상 ChromeOS만 해당

유형

ActivationStateType

열거형

'활성화됨'

'활성화 중'

'NotActivated'

'PartiallyActivated'

CaptivePortalStatus

열거형

'알 수 없음'

'오프라인'

'온라인'

'포털'

"ProxyAuthRequired"

CellularProperties

속성

  • ActivationState

    ActivationStateType 선택사항

    이동통신사 계정 활성화 상태입니다.

  • ActivationType

    문자열 선택사항

    셀룰러 네트워크 활성화 유형입니다.

  • AllowRoaming

    불리언 선택사항

    네트워크에 로밍이 허용되는지 여부입니다.

  • AutoConnect

    불리언 선택사항

    셀룰러 네트워크가 범위 내에 있을 때 자동으로 연결되어야 하는지 여부입니다.

  • 가족

    문자열 선택사항

    셀룰러 기기 기술 제품군 - CDMA 또는 GSM

  • FirmwareRevision

    문자열 선택사항

    셀룰러 모뎀에 로드된 펌웨어 버전입니다.

  • FoundNetworks

    FoundNetworkProperties[] 선택사항

    가장 최근 네트워크 검사 중에 발견된 네트워크 목록입니다.

  • HardwareRevision

    문자열 선택사항

    셀룰러 모뎀 하드웨어 버전입니다.

  • HomeProvider

    CellularProviderProperties 선택사항

    모뎀에 현재 설치된 SIM 카드를 발급한 사업자에 관한 정보입니다.

  • 제조업체

    문자열 선택사항

    모바일 모뎀 제조업체입니다.

  • ModelID

    문자열 선택사항

    셀룰러 모뎀 모델 ID입니다.

  • NetworkTechnology

    문자열 선택사항

    모뎀이 네트워크에 등록된 경우 현재 사용 중인 네트워크 기술입니다.

  • PaymentPortal

    PaymentPortal 선택사항

    사용자가 모바일 데이터 요금제에 가입하거나 수정하는 데 사용할 수 있는 온라인 결제 포털입니다.

  • RoamingState

    문자열 선택사항

    현재 네트워크에서 셀룰러 모뎀의 로밍 상태입니다.

  • SIMLockStatus

    SIMLockStatus 선택사항

    GSM 제품군 네트워크의 SIM 잠금 상태입니다.

  • SIMPresent

    불리언 선택사항

    SIM 카드가 있는지 여부

  • 검사

    불리언 선택사항

    Chrome 63 이상

    셀룰러 네트워크 스캔이 진행 중인 경우 true입니다.

  • ServingOperator

    CellularProviderProperties 선택사항

    모뎀이 현재 등록된 네트워크의 사업자에 관한 정보입니다.

  • SignalStrength

    number 선택사항

    현재 네트워크 신호 강도입니다.

  • SupportNetworkScan

    불리언 선택사항

    셀룰러 네트워크가 스캔을 지원하는지 여부입니다.

CellularProviderProperties

속성

  • 코드

    문자열

    네트워크의 MCC (모바일 국가 코드)와 MNC (모바일 네트워크 코드)를 간단히 연결한 셀룰러 네트워크 ID입니다.

  • 국가

    문자열 선택사항

    두 글자 국가 코드입니다.

  • 이름

    문자열

    연산자 이름입니다.

CellularStateProperties

속성

CertificatePattern

속성

  • EnrollmentURI

    string[] 선택사항

    이 패턴과 일치하는 인증서를 찾을 수 없는 경우 사용자를 안내할 수 있는 URI 목록입니다.

  • 발급자

    IssuerSubjectPattern 선택사항

    설정된 경우 X.509 발급기관 설정과 일치해야 하는 패턴입니다.

  • IssuerCARef

    string[] 선택사항

    인증서 발급기관 CA 인증서 목록입니다. 이 패턴과 일치하려면 인증서가 이 중 하나에 의해 서명되어야 합니다.

  • 제목

    IssuerSubjectPattern 선택사항

    설정된 경우 X.509 주체 설정과 일치해야 하는 패턴입니다.

ClientCertificateType

열거형

'참조'

'패턴'

ConnectionStateType

열거형

'연결됨'

'연결 중'

"NotConnected"

DeviceStateProperties

속성

  • SIMLockStatus

    SIMLockStatus 선택사항

    Chrome 62 이상

    Type = Cellular 및 SIMPresent = True인 경우 SIM 잠금 상태입니다.

  • SIMPresent

    불리언 선택사항

    Chrome 62 이상

    기기 유형이 셀룰러인 경우 SIM 현재 상태로 설정합니다.

  • 검사

    불리언 선택사항

    기기가 사용 설정되어 있는지 설정합니다. 기기가 현재 스캔 중이면 true입니다.

  • 기기의 현재 상태입니다.

  • 유형

    NetworkType

    기기와 연결된 네트워크 유형 (모바일 데이터, 이더넷 또는 Wi-Fi)입니다.

DeviceStateType

열거형

'초기화되지 않음'
기기를 사용할 수 있지만 초기화되지 않았습니다.

'사용 중지됨'
기기가 초기화되었지만 사용 설정되지 않았습니다.

'사용 설정 중'
사용 설정 상태가 요청되었지만 완료되지 않았습니다.

'사용 설정됨'
기기가 사용 설정되었습니다.

'Prohibited'
기기가 금지되었습니다.

EAPProperties

속성

  • AnonymousIdentity

    문자열 선택사항

  • ClientCertPKCS11Id

    문자열 선택사항

    Chrome 60 이상
  • ClientCertPattern

    CertificatePattern 선택사항

  • ClientCertProvisioningProfileId

    문자열 선택사항

    Chrome 93 이상
  • ClientCertRef

    문자열 선택사항

  • ClientCertType

    ClientCertificateType

  • ID

    문자열 선택사항

  • 내부

    문자열 선택사항

  • 외부

    문자열 선택사항

    외부 EAP 유형입니다. ONC에 필요하지만 Shill에서 변환할 때 제공되지 않을 수 있습니다.

  • 비밀번호

    문자열 선택사항

  • SaveCredentials

    불리언 선택사항

  • ServerCAPEMs

    string[] 선택사항

  • ServerCARefs

    string[] 선택사항

  • SubjectMatch

    ManagedDOMString 선택사항

    Chrome 60 이상
  • UseProactiveKeyCaching

    불리언 선택사항

  • UseSystemCAs

    불리언 선택사항

EthernetProperties

속성

  • 인증

    문자열 선택사항

    이더넷 네트워크에서 사용하는 인증입니다. 가능한 값은 None 및 8021X입니다.

  • AutoConnect

    불리언 선택사항

    이더넷 네트워크를 자동으로 연결할지 여부입니다.

  • EAP

    EAPProperties 선택사항

    네트워크의 EAP 설정입니다. 8021X 인증에 필요합니다.

EthernetStateProperties

속성

FoundNetworkProperties

속성

  • LongName

    문자열 선택사항

    네트워크 사업자의 긴 형식 이름입니다.

  • NetworkId

    문자열

    네트워크 ID입니다.

  • ShortName

    문자열 선택사항

    네트워크 사업자의 짧은 형식 이름입니다.

  • 상태

    문자열

    네트워크 가용성

  • 기술

    문자열

    네트워크에서 사용하는 액세스 기술입니다.

GlobalPolicy

속성

  • AllowOnlyPolicyNetworksToAutoconnect

    불리언 선택사항

    true인 경우 정책 네트워크만 자동 연결할 수 있습니다. 기본값은 false입니다.

  • AllowOnlyPolicyNetworksToConnect

    불리언 선택사항

    true인 경우 정책 네트워크만 연결할 수 있으며 새 네트워크를 추가하거나 구성할 수 없습니다. 기본값은 false입니다.

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    불리언 선택사항

    Chrome 70 이상

    true로 설정하고 표시되는 네트워크 목록에 관리 네트워크가 있는 경우 정책 네트워크에만 연결할 수 있으며 새 네트워크를 추가하거나 구성할 수 없습니다. 기본값은 false입니다.

  • BlockedHexSSIDs

    string[] 선택사항

    Chrome 86 이상

    차단된 네트워크 목록입니다. 차단된 네트워크에 연결할 수 없습니다. 명시적 네트워크 구성을 지정하여 네트워크를 다시 차단 해제할 수 있습니다. 기본값은 빈 목록입니다.

IPConfigProperties

속성

  • ExcludedRoutes

    string[] 선택사항

    Chrome 76 이상

    CIDR 표기법의 IP 블록 배열입니다. 자세한 내용은 onc_spec.md를 참고하세요.

  • 게이트웨이

    문자열 선택사항

    IP 구성에 사용되는 게이트웨이 주소입니다.

  • IPAddress

    문자열 선택사항

    연결의 IP 주소입니다. Type 값에 따라 IPv4 또는 IPv6 주소일 수 있습니다.

  • IncludedRoutes

    string[] 선택사항

    Chrome 76 이상

    CIDR 표기법의 IP 블록 배열입니다. 자세한 내용은 onc_spec.md를 참고하세요.

  • NameServers

    string[] 선택사항

    네임서버에 사용되는 주소 배열입니다.

  • RoutingPrefix

    number 선택사항

    라우팅 프리픽스입니다.

  • SearchDomains

    string[] 선택사항

    Chrome 76 이상

    이름 변환을 위한 문자열 배열입니다. 자세한 내용은 onc_spec.md를 참고하세요.

  • 유형

    문자열 선택사항

    IP 구성 유형입니다. IPv4 또는 IPv6일 수 있습니다.

  • WebProxyAutoDiscoveryUrl

    문자열 선택사항

    DHCP를 통해 보고된 웹 프록시 자동 검색의 URL입니다.

IPConfigType

열거형

'DHCP'

'정적'

IssuerSubjectPattern

속성

  • CommonName

    문자열 선택사항

    설정된 경우 인증서 주체의 일반 이름과 일치하는 값입니다.

  • 지역

    문자열 선택사항

    설정된 경우 인증서 주체의 공통 위치와 일치하는 값입니다.

  • 조직

    문자열 선택사항

    설정된 경우 인증서 주체의 조직과 일치하는 값입니다. 하나 이상의 조직이 값과 일치해야 합니다.

  • OrganizationalUnit

    문자열 선택사항

    설정된 경우 인증서 주체의 조직 단위와 일치하는 값입니다. 하나 이상의 조직 단위가 값과 일치해야 합니다.

ManagedBoolean

속성

  • 활성

    불리언 선택사항

    네트워크 구성 관리자 (예: Shill)에서 현재 사용하는 활성 값입니다.

  • DeviceEditable

    불리언 선택사항

    속성에 대한 DevicePolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함)입니다. 기본값은 false입니다.

  • DevicePolicy

    불리언 선택사항

    기기 정책에서 제공하는 속성 값입니다.

  • 유효

    문자열 선택사항

    유효 속성 값이 결정된 소스입니다.

  • SharedSetting

    불리언 선택사항

    기기의 모든 사용자에 대해 설정된 값입니다. DeviceEditiable가 true인 경우에만 제공됩니다.

  • UserEditable

    불리언 선택사항

    속성에 대한 UserPolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함) 기본값은 false입니다.

  • UserPolicy

    불리언 선택사항

    사용자 정책에서 제공하는 속성 값입니다.

  • UserSetting

    불리언 선택사항

    로그인한 사용자가 설정한 속성 값입니다. UserEditable가 true인 경우에만 제공됩니다.

ManagedCellularProperties

속성

ManagedDOMString

속성

  • 활성

    문자열 선택사항

    네트워크 구성 관리자 (예: Shill)에서 현재 사용하는 활성 값입니다.

  • DeviceEditable

    불리언 선택사항

    속성에 대한 DevicePolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함)입니다. 기본값은 false입니다.

  • DevicePolicy

    문자열 선택사항

    기기 정책에서 제공하는 속성 값입니다.

  • 유효

    문자열 선택사항

    유효 속성 값이 결정된 소스입니다.

  • SharedSetting

    문자열 선택사항

    기기의 모든 사용자에 대해 설정된 값입니다. DeviceEditiable가 true인 경우에만 제공됩니다.

  • UserEditable

    불리언 선택사항

    속성에 대한 UserPolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함) 기본값은 false입니다.

  • UserPolicy

    문자열 선택사항

    사용자 정책에서 제공하는 속성 값입니다.

  • UserSetting

    문자열 선택사항

    로그인한 사용자가 설정한 속성 값입니다. UserEditable가 true인 경우에만 제공됩니다.

ManagedDOMStringList

속성

  • 활성

    string[] 선택사항

    네트워크 구성 관리자 (예: Shill)에서 현재 사용하는 활성 값입니다.

  • DeviceEditable

    불리언 선택사항

    속성에 대한 DevicePolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함)입니다. 기본값은 false입니다.

  • DevicePolicy

    string[] 선택사항

    기기 정책에서 제공하는 속성 값입니다.

  • 유효

    문자열 선택사항

    유효 속성 값이 결정된 소스입니다.

  • SharedSetting

    string[] 선택사항

    기기의 모든 사용자에 대해 설정된 값입니다. DeviceEditiable가 true인 경우에만 제공됩니다.

  • UserEditable

    불리언 선택사항

    속성에 대한 UserPolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함) 기본값은 false입니다.

  • UserPolicy

    string[] 선택사항

    사용자 정책에서 제공하는 속성 값입니다.

  • UserSetting

    string[] 선택사항

    로그인한 사용자가 설정한 속성 값입니다. UserEditable가 true인 경우에만 제공됩니다.

ManagedEthernetProperties

속성

ManagedIPConfigProperties

속성

ManagedIPConfigType

속성

  • 활성

    IPConfigType 선택사항

    네트워크 구성 관리자 (예: Shill)에서 현재 사용하는 활성 값입니다.

  • DeviceEditable

    불리언 선택사항

    속성에 대한 DevicePolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함)입니다. 기본값은 false입니다.

  • DevicePolicy

    IPConfigType 선택사항

    기기 정책에서 제공하는 속성 값입니다.

  • 유효

    문자열 선택사항

    유효 속성 값이 결정된 소스입니다.

  • SharedSetting

    IPConfigType 선택사항

    기기의 모든 사용자에 대해 설정된 값입니다. DeviceEditiable가 true인 경우에만 제공됩니다.

  • UserEditable

    불리언 선택사항

    속성에 대한 UserPolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함) 기본값은 false입니다.

  • UserPolicy

    IPConfigType 선택사항

    사용자 정책에서 제공하는 속성 값입니다.

  • UserSetting

    IPConfigType 선택사항

    로그인한 사용자가 설정한 속성 값입니다. UserEditable가 true인 경우에만 제공됩니다.

ManagedLong

속성

  • 활성

    number 선택사항

    네트워크 구성 관리자 (예: Shill)에서 현재 사용하는 활성 값입니다.

  • DeviceEditable

    불리언 선택사항

    속성에 대한 DevicePolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함)입니다. 기본값은 false입니다.

  • DevicePolicy

    number 선택사항

    기기 정책에서 제공하는 속성 값입니다.

  • 유효

    문자열 선택사항

    유효 속성 값이 결정된 소스입니다.

  • SharedSetting

    number 선택사항

    기기의 모든 사용자에 대해 설정된 값입니다. DeviceEditiable가 true인 경우에만 제공됩니다.

  • UserEditable

    불리언 선택사항

    속성에 대한 UserPolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함) 기본값은 false입니다.

  • UserPolicy

    number 선택사항

    사용자 정책에서 제공하는 속성 값입니다.

  • UserSetting

    number 선택사항

    로그인한 사용자가 설정한 속성 값입니다. UserEditable가 true인 경우에만 제공됩니다.

ManagedManualProxySettings

속성

ManagedProperties

속성

ManagedProxyLocation

속성

ManagedProxySettings

속성

ManagedProxySettingsType

속성

  • 활성

    ProxySettingsType 선택사항

    네트워크 구성 관리자 (예: Shill)에서 현재 사용하는 활성 값입니다.

  • DeviceEditable

    불리언 선택사항

    속성에 대한 DevicePolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함)입니다. 기본값은 false입니다.

  • DevicePolicy

    ProxySettingsType 선택사항

    기기 정책에서 제공하는 속성 값입니다.

  • 유효

    문자열 선택사항

    유효 속성 값이 결정된 소스입니다.

  • SharedSetting

    ProxySettingsType 선택사항

    기기의 모든 사용자에 대해 설정된 값입니다. DeviceEditiable가 true인 경우에만 제공됩니다.

  • UserEditable

    불리언 선택사항

    속성에 대한 UserPolicy가 존재하고 속성을 수정할 수 있는지 여부 (즉, 정책에서 권장 속성 값을 설정함) 기본값은 false입니다.

  • UserPolicy

    ProxySettingsType 선택사항

    사용자 정책에서 제공하는 속성 값입니다.

  • UserSetting

    ProxySettingsType 선택사항

    로그인한 사용자가 설정한 속성 값입니다. UserEditable가 true인 경우에만 제공됩니다.

ManagedThirdPartyVPNProperties

속성

ManagedVPNProperties

속성

ManagedWiFiProperties

속성

ManualProxySettings

속성

  • FTPProxy

    ProxyLocation 선택사항

    FTP 프록시 설정입니다.

  • HTTPProxy

    ProxyLocation 선택사항

    HTTP 프록시 설정입니다.

  • SOCKS

    ProxyLocation 선택사항

    SOCKS 프록시 설정입니다.

  • SecureHTTPProxy

    ProxyLocation 선택사항

    보안 HTTP 프록시 설정입니다.

NetworkConfigProperties

속성

NetworkFilter

속성

  • 구성됨

    불리언 선택사항

    true인 경우 구성된 (저장된) 네트워크만 포함합니다. 기본값은 'false'입니다.

  • 제한

    number 선택사항

    반환할 최대 네트워크 수입니다. 지정하지 않으면 기본값은 1000입니다. 제한이 없으면 0을 사용합니다.

  • networkType

    NetworkType

    반환할 네트워크 유형입니다.

  • visible

    불리언 선택사항

    true인 경우 표시되는 (물리적으로 연결되거나 범위 내에 있는) 네트워크만 포함합니다. 기본값은 'false'입니다.

NetworkProperties

속성

  • 모바일 데이터

    CellularProperties 선택사항

    셀룰러 네트워크의 경우 셀룰러 네트워크 속성입니다.

  • 연결 가능

    불리언 선택사항

    네트워크 연결 가능 여부입니다.

  • ConnectionState

    ConnectionStateType 선택사항

    네트워크의 현재 연결 상태입니다.

  • ErrorState

    문자열 선택사항

    마지막으로 기록된 네트워크 오류 상태입니다.

  • 이더넷

    EthernetProperties 선택사항

    이더넷 네트워크의 경우 이더넷 네트워크 속성입니다.

  • GUID

    문자열

    네트워크 GUID입니다.

  • IPAddressConfigType

    IPConfigType 선택사항

    네트워크의 IP 주소 구성 유형입니다.

  • IPConfigs

    IPConfigProperties[] 선택사항

    네트워크의 IP 구성입니다.

  • MacAddress

    문자열 선택사항

    네트워크의 MAC 주소입니다.

  • 종량제 네트워크

    불리언 선택사항

    Chrome 85 이상

    네트워크가 데이터 전송량 무제한인지 여부입니다.

  • 이름

    문자열 선택사항

    사용자 친화적인 네트워크 이름입니다.

  • NameServersConfigType

    IPConfigType 선택사항

    네트워크에서 사용하는 네임서버의 IP 구성 유형입니다.

  • 우선순위

    number 선택사항

    네트워크 우선순위입니다.

  • ProxySettings

    ProxySettings 선택사항

    네트워크의 프록시 설정입니다.

  • RestrictedConnectivity

    불리언 선택사항

    연결된 네트워크의 경우 인터넷에 대한 네트워크 연결이 제한되어 있는지 여부입니다(예: 네트워크가 포털 뒤에 있거나 셀룰러 네트워크가 활성화되지 않은 경우).

  • SavedIPConfig

    IPConfigProperties 선택사항

    고정 IP 구성을 적용하기 전에 DHCP 서버에서 수신한 IP 구성입니다.

  • 소스

    문자열 선택사항

    네트워크 구성 여부와 방법을 나타냅니다. 가능한 값은 다음과 같습니다.

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    'None'은 확장 프로그램 코드 생성과 충돌하므로 SourceType enum 대신 'Source'에 문자열을 사용해야 합니다.

  • StaticIPConfig

    IPConfigProperties 선택사항

    네트워크의 고정 IP 구성입니다.

  • TrafficCounterResetTime

    number 선택사항

    Chrome 125 이상

    트래픽 카운터가 마지막으로 재설정된 시간입니다.

  • 유형

    NetworkType

    네트워크 유형입니다.

  • VPN

    VPNProperties 선택사항

    VPN 네트워크의 경우 네트워크 VPN 속성입니다.

  • Wi-Fi

    WiFiProperties 선택사항

    Wi-Fi 네트워크의 경우 네트워크 Wi-Fi 속성입니다.

NetworkStateProperties

속성

NetworkType

열거형

'전체'

'모바일'

'이더넷'

'테더링'

'VPN'

'무선'

"WiFi"

PaymentPortal

속성

  • 메서드

    문자열

    결제 포털에 사용할 HTTP 메서드입니다.

  • PostData

    문자열 선택사항

    결제 포털로 전송할 게시물 데이터입니다. Method가 POST가 아니면 무시됩니다.

  • URL

    문자열 선택사항

    결제 포털 URL입니다.

ProxyLocation

속성

  • 호스트

    문자열

    프록시 IP 주소 호스트입니다.

  • 포트

    숫자

    프록시에 사용할 포트입니다.

ProxySettings

속성

  • ExcludeDomains

    string[] 선택사항

    수동 프록시 설정이 제외되는 도메인 및 호스트입니다.

  • 수동

    ManualProxySettings 선택사항

    수동 프록시 설정 - Manual 프록시 설정에만 사용됩니다.

  • PAC

    문자열 선택사항

    프록시 자동 구성 파일의 URL입니다.

  • 프록시 설정 유형입니다.

ProxySettingsType

열거형

'직접'

'수동'

'PAC'

'WPAD'

SIMLockStatus

속성

  • LockEnabled

    부울

    SIM 잠금 사용 설정 여부

  • LockType

    문자열

    SIM 잠금 상태입니다. 가능한 값은 'sim-pin', 'sim-puk', ''입니다.

  • RetriesLeft

    number 선택사항

    SIM을 잠금 해제하기 위해 PUK가 필요하기 전에 허용되는 PIN 잠금 시도 횟수입니다.

ThirdPartyVPNProperties

속성

  • ExtensionID

    문자열

    서드 파티 VPN 제공업체 확장 프로그램의 ID입니다.

  • ProviderName

    문자열 선택사항

    VPN 제공업체 이름입니다.

VPNProperties

속성

  • AutoConnect

    불리언 선택사항

    I: VPN 네트워크를 자동으로 연결할지 여부입니다.

  • 호스트

    문자열 선택사항

    VPN 호스트입니다.

  • 유형

    문자열 선택사항

    VPN 유형입니다. 'L2TP-IPSec' 때문에 enum일 수 없습니다. 이는 setProperties에 전달되는 NetworkConfigProperties의 경우 선택사항이며, 특정 속성만 설정하는 데 사용될 수 있습니다.

VPNStateProperties

속성

WiFiProperties

속성

  • AllowGatewayARPPolling

    불리언 선택사항

    Chrome 131부터 지원 중단됨

    M131에서 삭제되었습니다. 현재 활성 상태의 ARP 폴링이 없습니다.

  • AutoConnect

    불리언 선택사항

    범위 내에 있을 때 Wi-Fi 네트워크를 자동으로 연결할지 여부입니다.

  • BSSID : 기본 서비스 세트 식별자

    문자열 선택사항

    연결된 액세스 포인트의 BSSID입니다.

  • EAP

    EAPProperties 선택사항

    네트워크 EAP 속성입니다. WEP-8021X 및 WPA-EAP 네트워크에 필요합니다.

  • 빈도

    number 선택사항

    Wi-Fi 서비스 작동 주파수(MHz)입니다. 연결된 네트워크의 경우 네트워크가 연결된 현재 주파수입니다. 그렇지 않으면 사용 가능한 최상의 BSS 주파수입니다.

  • FrequencyList

    number[] 선택사항

    Wi-Fi 네트워크에서 최근에 확인된 모든 작동 주파수를 포함합니다.

  • HexSSID

    문자열 선택사항

    네트워크 SSID의 HEX 인코딩 사본입니다.

  • HiddenSSID

    불리언 선택사항

    네트워크 SSID가 브로드캐스트되는지 여부입니다.

  • 암호

    문자열 선택사항

    Chrome 66 이상

    WEP/WPA/WPA2 연결의 암호입니다. 이 속성은 설정만 가능하며 getProperties에서 반환하는 속성에는 이 값이 포함되지 않습니다.

  • RoamThreshold

    number 선택사항

    지원 중단되고 무시됩니다.

  • SSID

    문자열 선택사항

    네트워크 SSID입니다.

  • 보안

    문자열 선택사항

    네트워크 보안 유형입니다.

  • SignalStrength

    number 선택사항

    네트워크 신호 강도입니다.

WiFiStateProperties

속성

WiMAXProperties

속성

  • AutoConnect

    불리언 선택사항

    네트워크를 자동으로 연결할지 여부입니다.

  • EAP

    EAPProperties 선택사항

    네트워크 EAP 속성입니다.

메서드

createNetwork()

Promise 
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<string>

속성에서 새 네트워크 구성을 만듭니다. 일치하는 구성된 네트워크가 이미 있으면 실패합니다. 그렇지 않으면 새 네트워크의 GUID를 반환합니다.

매개변수

  • 공유

    부울

    true인 경우 이 네트워크 구성을 다른 사용자와 공유합니다.

    이 옵션은 Chrome의 웹 UI에만 표시됩니다.* 앱에서 호출하는 경우 허용되는 유일한 값은 false입니다.

  • 새 네트워크를 구성할 속성입니다.

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (result: string) => void

    • 결과

      문자열

반환 값

  • Promise<string>

    Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

disableNetworkType()

chrome.networking.onc.disableNetworkType(
  networkType: NetworkType,
): void

지정된 네트워크 유형과 일치하는 모든 기기를 사용 중지합니다. enableNetworkType 참고사항을 확인하세요.

매개변수

  • networkType

    NetworkType

    사용 중지할 네트워크 유형입니다.

enableNetworkType()

chrome.networking.onc.enableNetworkType(
  networkType: NetworkType,
): void

지정된 네트워크 유형과 일치하는 모든 기기를 사용 설정합니다. 유형은 여러 네트워크 유형 (예: '무선')을 나타낼 수 있습니다.

매개변수

  • networkType

    NetworkType

    사용 설정할 네트워크 유형입니다.

forgetNetwork()

Promise 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
): Promise<void>

GUID가 networkGuid인 네트워크에 구성된 속성을 삭제하여 네트워크 구성을 삭제합니다. 여기에는 일치하는 식별자 (예: Wi-Fi SSID 및 보안)가 있는 다른 네트워크도 포함될 수 있습니다. 이러한 구성이 없으면 오류가 설정되고 작업이 실패합니다.

키오스크 세션에서는 이 메서드로 공유 네트워크 구성을 삭제할 수 없습니다.

매개변수

  • networkGuid

    문자열

    삭제할 네트워크의 GUID입니다.

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    () => void

반환 값

  • 약속<void>

    Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getCaptivePortalStatus()

Promise 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
): Promise<CaptivePortalStatus>

'networkGuid'와 일치하는 네트워크의 종속 포털 상태를 반환합니다.

매개변수

  • networkGuid

    문자열

    종속 포털 상태를 가져올 네트워크의 GUID입니다.

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (result: CaptivePortalStatus) => void

반환 값

  • Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getDeviceStates()

Promise 
chrome.networking.onc.getDeviceStates(
  callback?: function,
): Promise<DeviceStateProperties[]>

사용 가능한 네트워킹 기기의 상태를 반환합니다.

매개변수

반환 값

  • Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getGlobalPolicy()

Promise 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
): Promise<GlobalPolicy>

전역 정책 속성을 가져옵니다. 이러한 속성은 세션 중에 변경되지 않습니다.

매개변수

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (result: GlobalPolicy) => void

반환 값

  • Promise<GlobalPolicy>

    Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getManagedProperties()

Promise 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
): Promise<ManagedProperties>

사용자 설정, 공유 설정, 사용자 정책, 기기 정책, 현재 활성 설정 등의 소스에서 ID가 networkGuid인 네트워크의 병합된 속성을 가져옵니다.

매개변수

  • networkGuid

    문자열

    속성을 가져올 네트워크의 GUID입니다.

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (result: ManagedProperties) => void

반환 값

  • Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getNetworks()

Promise 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
): Promise<NetworkStateProperties[]>

getState에서 제공하는 것과 동일한 속성을 가진 네트워크 객체 목록을 반환합니다. 반환되는 네트워크 유형을 지정하고 네트워크 수를 제한하는 필터가 제공됩니다. 네트워크는 우선순위에 따라 시스템에서 정렬되며, 연결된 네트워크 또는 연결 중인 네트워크가 먼저 표시됩니다.

매개변수

반환 값

  • Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getProperties()

Promise 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
): Promise<NetworkProperties>

ID가 networkGuid인 네트워크의 모든 속성을 가져옵니다. 네트워크의 모든 속성 (읽기 전용 및 읽기/쓰기 값)을 포함합니다.

매개변수

  • networkGuid

    문자열

    속성을 가져올 네트워크의 GUID입니다.

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (result: NetworkProperties) => void

반환 값

  • Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

getState()

Promise 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
): Promise<NetworkStateProperties>

ID가 networkGuid인 네트워크의 캐시된 읽기 전용 속성을 가져옵니다. 이는 네트워킹 하위 시스템을 쿼리하기 위해 왕복이 필요한 getProperties보다 더 높은 성능의 함수입니다. 모든 네트워크에 대해 GUID, 유형, 이름, WiFi.Security 속성이 반환됩니다. 표시되는 네트워크에 대해 ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState와 같은 추가 속성이 제공됩니다.

매개변수

  • networkGuid

    문자열

    속성을 가져올 네트워크의 GUID입니다.

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (result: NetworkStateProperties) => void

반환 값

  • Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

requestNetworkScan()

chrome.networking.onc.requestNetworkScan(
  networkType?: NetworkType,
): void

네트워킹 하위 시스템이 새 네트워크를 검색하고 getVisibleNetworks에서 반환된 목록을 업데이트하도록 요청합니다. 이는 요청일 뿐이며 네트워크 하위 시스템은 이를 무시할 수 있습니다. 목록이 업데이트되면 onNetworkListChanged 이벤트가 실행됩니다.

매개변수

  • networkType

    NetworkType 선택사항

    Chrome 63 이상

    제공된 경우 유형에 맞는 스캔을 요청합니다. 셀룰러의 경우 지원되는 경우 모바일 네트워크 스캔이 요청됩니다.

setProperties()

Promise 
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<void>

ID가 networkGuid인 네트워크의 속성을 설정합니다. 이는 구성된 네트워크 (소스 != 없음)에만 유효합니다. 구성되지 않은 표시되는 네트워크는 대신 createNetwork를 사용해야 합니다. 키오스크 세션에서 공유 네트워크에 이 메서드를 호출하면 실패합니다.

매개변수

  • networkGuid

    문자열

    속성을 설정할 네트워크의 GUID입니다.

  • 설정할 속성입니다.

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    () => void

반환 값

  • 약속<void>

    Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

startConnect()

Promise 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

networkGuid를 사용하여 네트워크에 대한 연결을 시작합니다.

매개변수

  • networkGuid

    문자열

    연결할 네트워크의 GUID입니다.

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    () => void

반환 값

  • 약속<void>

    Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

startDisconnect()

Promise 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

networkGuid를 사용하여 네트워크 연결 해제를 시작합니다.

매개변수

  • networkGuid

    문자열

    연결을 해제할 네트워크의 GUID입니다.

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    () => void

반환 값

  • 약속<void>

    Chrome 125 이상

    프로미스는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

이벤트

onDeviceStateListChanged

chrome.networking.onc.onDeviceStateListChanged.addListener(
  callback: function,
)

기기 목록이 변경되거나 기기 상태 속성이 변경되면 실행됩니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    () => void

onNetworkListChanged

chrome.networking.onc.onNetworkListChanged.addListener(
  callback: function,
)

네트워크 목록이 변경되면 실행됩니다. 현재 모든 네트워크의 GUID 전체 목록을 전송합니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (changes: string[]) => void

    • 변경사항

      문자열[]

onNetworksChanged

chrome.networking.onc.onNetworksChanged.addListener(
  callback: function,
)

네트워크에서 속성이 변경될 때 실행됩니다. 속성이 변경된 네트워크의 GUID 목록을 전송합니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (changes: string[]) => void

    • 변경사항

      문자열[]

onPortalDetectionCompleted

chrome.networking.onc.onPortalDetectionCompleted.addListener(
  callback: function,
)

네트워크의 포털 감지가 완료되면 실행됩니다. 네트워크의 GUID와 해당 종속 포털 상태를 전송합니다.

매개변수