chrome.networking.onc

설명

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

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

참고: 대부분의 사전 속성과 열거형 값은 JavaScript의 lowerCamelCase 규칙 대신 ONC 사양에 맞게 UpperCamelCase를 사용합니다.

권한

networking.onc

가용성

Chrome 59 이상 ChromeOS만 해당

유형

ActivationStateType

열거형

'활성화됨'

'Activating'(활성화 중)

'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

    번호 선택사항

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

  • SupportNetworkScan

    불리언 선택사항

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

CellularProviderProperties

속성

  • 코드

    문자열

    네트워크의 MCC (모바일 국가 코드) 및 MNC (모바일 네트워크 코드)를 단순히 연결한 모바일 네트워크 ID입니다.

  • 국가

    문자열 선택사항

    2자리 국가 코드입니다.

  • 이름

    문자열

    운영자 이름입니다.

CellularStateProperties

속성

CertificatePattern

속성

  • EnrollmentURI

    string[] 선택사항

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

  • 발급자

    IssuerSubjectPattern 선택사항

    설정된 경우 X.509 발급자 설정을 일치시켜야 하는 패턴입니다.

  • IssuerCARef

    string[] 선택사항

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

  • 제목

    IssuerSubjectPattern 선택사항

    설정된 경우 X.509 제목 설정을 일치시켜야 하는 패턴입니다.

ClientCertificateType

열거형

'Ref'

'패턴'

ConnectionStateType

열거형

'연결됨'

'연결 중'

"NotConnected"

DeviceStateProperties

속성

  • SIMLockStatus

    SIMLockStatus 선택사항

    Chrome 62 이상

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

  • SIMPresent

    불리언 선택사항

    Chrome 62 이상

    기기 유형이 Cellular인 경우 SIM이 있는 상태로 설정합니다.

  • 검사

    불리언 선택사항

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

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

  • 유형

    NetworkType

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

DeviceStateType

열거형

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

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

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

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

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

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

    번호 선택사항

    라우팅 접두사입니다.

  • 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

속성

  • 활성

    번호 선택사항

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

  • DeviceEditable

    불리언 선택사항

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

  • DevicePolicy

    번호 선택사항

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

  • 유효

    문자열 선택사항

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

  • SharedSetting

    번호 선택사항

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

  • UserEditable

    불리언 선택사항

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

  • UserPolicy

    번호 선택사항

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

  • UserSetting

    번호 선택사항

    로그인한 사용자가 설정한 속성 값입니다. 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

속성

NetworkConfigProperties

속성

NetworkFilter

속성

  • 구성됨

    불리언 선택사항

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

  • 제한

    번호 선택사항

    반환할 최대 방송 네트워크 수입니다. 지정되지 않은 경우 기본값은 1000입니다. 제한이 없으면 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 구성 유형입니다.

  • 우선순위

    번호 선택사항

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

  • ProxySettings

    ProxySettings 선택사항

    네트워크의 프록시 설정

  • RestrictedConnectivity

    불리언 선택사항

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

  • SavedIPConfig

    IPConfigProperties 선택사항

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

  • 소스

    문자열 선택사항

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

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

  • StaticIPConfig

    IPConfigProperties 선택사항

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

  • TrafficCounterResetTime

    번호 선택사항

    Chrome 125 이상

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

  • 유형

    NetworkType

    네트워크 유형입니다.

  • VPN

    VPNProperties 선택사항

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

  • Wi-Fi

    WiFiProperties 선택사항

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

NetworkStateProperties

속성

NetworkType

열거형

'모두'

'Cellular'

'이더넷'

'테더링'

'VPN'

'무선'

'Wi-Fi'

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

    번호 선택사항

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

ThirdPartyVPNProperties

속성

  • ExtensionID

    문자열

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

  • ProviderName

    문자열 선택사항

    VPN 제공업체 이름입니다.

VPNProperties

속성

  • AutoConnect

    불리언 선택사항

    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 네트워크에 필요합니다.

  • 빈도

    번호 선택사항

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

  • FrequencyList

    number[] 선택사항

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

  • HexSSID

    문자열 선택사항

    네트워크 SSID의 16진수 인코딩된 사본입니다.

  • HiddenSSID

    불리언 선택사항

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

  • 암호

    문자열 선택사항

    Chrome 66 이상

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

  • RoamThreshold

    번호 선택사항

    지원 중단됨, 무시됨

  • SSID

    문자열 선택사항

    네트워크 SSID입니다.

  • 보안

    문자열 선택사항

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

  • SignalStrength

    번호 선택사항

    네트워크 신호 강도

WiFiStateProperties

속성

WiMAXProperties

속성

  • AutoConnect

    불리언 선택사항

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

  • EAP

    EAPProperties 선택사항

    네트워크 EAP 속성입니다.

메서드

createNetwork()

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

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

매개변수

  • 공유

    부울

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

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

  • 새 네트워크를 구성하는 데 사용할 속성입니다.

  • 콜백

    함수 선택사항

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

    (result: string) => void

    • 결과

      문자열

반환 값

  • Promise<string>

    Chrome 125 이상

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

disableNetworkType()

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

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

매개변수

  • networkType

    NetworkType

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

enableNetworkType()

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

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

매개변수

  • networkType

    NetworkType

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

forgetNetwork()

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

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

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

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise&lt;void&gt;

    Chrome 125 이상

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

getCaptivePortalStatus()

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

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

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: CaptivePortalStatus) => void

반환 값

  • Chrome 125 이상

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

getDeviceStates()

Promise 
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

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

매개변수

반환 값

  • Chrome 125 이상

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

getGlobalPolicy()

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

전역 정책 속성을 가져옵니다. 이러한 속성은 세션 중에 변경되지 않을 것으로 예상됩니다.

매개변수

  • 콜백

    함수 선택사항

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

    (result: GlobalPolicy) => void

반환 값

  • Promise<GlobalPolicy>

    Chrome 125 이상

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

getManagedProperties()

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

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

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: ManagedProperties) => void

반환 값

  • Chrome 125 이상

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

getNetworks()

Promise 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

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

매개변수

반환 값

  • Chrome 125 이상

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

getProperties()

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

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

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: NetworkProperties) => void

반환 값

  • Chrome 125 이상

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

getState()

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

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

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    (result: NetworkStateProperties) => void

반환 값

  • Chrome 125 이상

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

requestNetworkScan()

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

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

매개변수

  • networkType

    NetworkType 선택사항

    Chrome 63 이상

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

setProperties()

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

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

매개변수

  • networkGuid

    문자열

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

  • 설정할 속성입니다.

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise&lt;void&gt;

    Chrome 125 이상

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

startConnect()

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

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

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise&lt;void&gt;

    Chrome 125 이상

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

startDisconnect()

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

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

매개변수

  • networkGuid

    문자열

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

  • 콜백

    함수 선택사항

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

    () => void

반환 값

  • Promise&lt;void&gt;

    Chrome 125 이상

    Promise는 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와 해당 종속 포털 상태를 전송합니다.

매개변수