chrome.networking.onc

설명

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

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

참고: 대부분의 사전 속성 및 enum 값은 ONC 사양과 일치하도록 자바스크립트 lowerCamelCase 규칙 대신 UpperCamelCase를 사용합니다.

권한

networking.onc

가용성

Chrome 59 이상 ChromeOS만 해당

유형

ActivationStateType

enum

CaptivePortalStatus

enum

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입니다.

  • 국가

    문자열 선택사항

    2자리 국가 코드입니다.

  • 이름

    문자열

    연산자 이름입니다.

CellularStateProperties

속성

CertificatePattern

속성

  • EnrollmentURI

    string[] 선택사항

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

  • 발급자

    IssuerSubjectPattern 선택사항

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

  • IssuerCARef

    string[] 선택사항

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

  • 제목

    IssuerSubjectPattern 선택사항

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

ClientCertificateType

enum

ConnectionStateType

enum

DeviceStateProperties

속성

  • SIMLockStatus

    SIMLockStatus 선택사항

    Chrome 62 이상

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

  • SIMPresent

    부울 선택사항

    Chrome 62 이상

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

  • 검사

    부울 선택사항

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

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

  • 유형

    NetworkType

    기기와 연결된 네트워크 유형 (셀룰러, 이더넷 또는 Wi-Fi)입니다.

DeviceStateType

enum

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

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

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

"Enabled"
기기가 사용 설정되었습니다.

'금지됨'
금지된 기기입니다.

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인 경우 정책 네트워크만 자동으로 연결할 수 있습니다. 기본값은 거짓입니다.

  • AllowOnlyPolicyNetworksToConnect

    부울 선택사항

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

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    부울 선택사항

    Chrome 70 이상

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

  • 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를 통해 보고된 WEb 프록시 자동 검색의 URL입니다.

IPConfigType

enum

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 프록시 설정입니다.

  • 양말

    ProxyLocation 선택사항

    SOCKS 프록시 설정

  • SecureHTTPProxy

    ProxyLocation 선택사항

    보안 HTTP 프록시 설정

NetworkConfigProperties

속성

NetworkFilter

속성

  • 구성됨

    부울 선택사항

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

  • 제한

    number 선택사항

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

  • networkType

    NetworkType

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

  • 표시

    부울 선택사항

    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 선택사항

    대기중

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

  • 유형

    NetworkType

    네트워크 유형입니다.

  • VPN

    VPNProperties 선택사항

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

  • WiFi

    WiFiProperties 선택사항

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

NetworkStateProperties

속성

NetworkType

enum

PaymentPortal

속성

  • 메서드

    문자열

    결제 포털에 사용할 HTTP 방법입니다.

  • PostData

    문자열 선택사항

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

  • URL

    문자열 선택사항

    결제 포털 URL

ProxyLocation

속성

  • 호스트

    문자열

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

  • 포트

    숫자

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

ProxySettings

속성

  • ExcludeDomains

    string[] 선택사항

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

  • 수동

    ManualProxySettings 선택사항

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

  • PAC

    문자열 선택사항

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

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

ProxySettingsType

enum

SIMLockStatus

속성

  • LockEnabled

    boolean

    SIM 잠금 사용 설정 여부

  • LockType

    문자열

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

  • RetriesLeft

    number 선택사항

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

ThirdPartyVPNProperties

속성

  • ExtensionID

    문자열

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

  • ProviderName

    문자열 선택사항

    VPN 제공업체 이름입니다.

VPNProperties

속성

  • AutoConnect

    부울 선택사항

    VPN 네트워크를 자동으로 연결해야 하는지 여부입니다.

  • 호스트

    문자열 선택사항

    VPN 호스트입니다.

  • 유형

    문자열 선택사항

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

VPNStateProperties

속성

WiFiProperties

속성

  • AllowGatewayARPPolling

    부울 선택사항

    기본 게이트웨이의 ARP 폴링 허용 여부입니다. 기본값은 true입니다.

  • AutoConnect

    부울 선택사항

    범위 내에 있을 때 Wi-Fi 네트워크를 자동으로 연결해야 하는지 여부를 나타냅니다.

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

    문자열 선택사항

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

  • EAP

    EAPProperties 선택사항

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

  • 주파수

    number 선택사항

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

  • FrequencyList

    number[] 선택사항

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

  • HexSSID

    문자열 선택사항

    네트워크 SSID의 16진수 인코딩 사본

  • HiddenSSID

    부울 선택사항

    네트워크 SSID의 브로드캐스트 여부입니다.

  • 암호

    문자열 선택사항

    Chrome 66 이상

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

  • RoamThreshold

    number 선택사항

    지원 중단되었으며 무시됩니다.

  • SSID

    문자열 선택사항

    네트워크 SSID입니다.

  • 보안

    문자열 선택사항

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

  • SignalStrength

    number 선택사항

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

WiFiStateProperties

속성

WiMAXProperties

속성

  • AutoConnect

    부울 선택사항

    네트워크를 자동으로 연결해야 하는지 여부입니다.

  • EAP

    EAPProperties 선택사항

    네트워크 EAP 속성입니다.

방법

createNetwork()

프로미스 
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
)

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

매개변수

  • shared

    boolean

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

    이 옵션은 Chrome 웹 UI에만 노출됩니다.* 앱에서 호출할 때 허용되는 값은 false뿐입니다.

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

  • 콜백

    함수 선택사항

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

    (result: string)=>void

    • 결과

      문자열

반환 값

  • 프로미스<string>

    대기중

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

disableNetworkType()

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

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

매개변수

  • networkType

    NetworkType

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

enableNetworkType()

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

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

매개변수

  • networkType

    NetworkType

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

forgetNetwork()

프로미스 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
)

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

키오스크 세션에서 이 방법을 사용하면 공유 네트워크 구성이 삭제되지 않습니다.

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    대기중

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

getCaptivePortalStatus()

프로미스 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
)

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

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: CaptivePortalStatus)=>void

반환 값

  • 대기중

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

getDeviceStates()

프로미스 
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

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

매개변수

반환 값

  • 대기중

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

getGlobalPolicy()

프로미스 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
)

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

매개변수

  • 콜백

    함수 선택사항

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

    (result: GlobalPolicy)=>void

반환 값

  • Promise<GlobalPolicy>

    대기중

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

getManagedProperties()

프로미스 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
)

소스에서 id networkGuid가 있는 네트워크의 병합된 속성(사용자 설정, 공유 설정, 사용자 정책, 기기 정책 및 현재 활성 설정)을 가져옵니다.

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: ManagedProperties)=>void

반환 값

  • 대기중

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

getNetworks()

프로미스 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

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

매개변수

반환 값

  • 대기중

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

getProperties()

프로미스 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
)

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

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: NetworkProperties)=>void

반환 값

  • 대기중

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

getState()

프로미스 
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
)

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

매개변수

반환 값

  • 대기중

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

requestNetworkScan()

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

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

매개변수

  • networkType

    NetworkType 선택사항

    Chrome 63 이상

    제공되는 경우 유형에 맞는 검사를 요청합니다. 모바일 데이터 서비스의 경우 지원되는 경우 모바일 네트워크 스캔이 요청됩니다.

setProperties()

프로미스 
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
)

ID가 networkGuid인 네트워크의 속성을 설정합니다. 구성된 네트워크에만 유효합니다 (Source != None). 구성되지 않은 공개 네트워크에서는 createNetwork를 대신 사용해야 합니다. 키오스크 세션에서는 공유 네트워크에서 이 메서드를 호출할 수 없습니다.

매개변수

  • networkGuid

    문자열

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

  • 설정할 속성입니다.

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    대기중

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

startConnect()

프로미스 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
)

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

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    대기중

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

startDisconnect()

프로미스 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
)

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

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    ()=>void

반환 값

  • Promise<void>

    대기중

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

이벤트

onDeviceStateListChanged

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

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

매개변수

  • 콜백

    기능

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

    ()=>void

onNetworkListChanged

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

네트워크 목록이 변경되면 시작됩니다. 모든 현재 네트워크에 대한 전체 GUID 목록을 보냅니다.

매개변수

  • 콜백

    기능

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

    (changes: string[])=>void

    • 변경사항

      문자열[]

onNetworksChanged

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

네트워크에서 속성이 변경되면 시작됩니다. 속성이 변경된 네트워크의 GUID 목록을 보냅니다.

매개변수

  • 콜백

    기능

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

    (changes: string[])=>void

    • 변경사항

      문자열[]

onPortalDetectionCompleted

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

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

매개변수