java.net
클래스 Authenticator

java.lang.Object 
  java.net.Authenticator

public abstract class Authenticator
extends Object 

Authenticator 클래스는 네트워크 접속에 필요한 인증을 취득하기 위한 객체를 나타냅니다. 일반적으로 사용자에 게 정보의 입력을 요구하는 것으로 인증을 실시합니다.

어플리케이션은 서브 클래스에서 getPasswordAuthentication()를 오버라이드(override) 하는 것으로 이 클래스를 사용합니다. 이 메서드는 보통, 다양한 getXXX() 액세스용 메서드를 사용해, 인증을 요구하고 있는 엔티티에 관한 정보를 취득합니다. 다음에 사용자와의 대화, 또는 그 외의 대화 이외 방법으로 사용자 명과 패스워드를 취득할 필요가 있습니다. 그 후, PasswordAuthentication 반환값으로서 자격이 리턴됩니다 .

다음에 setDefault(Authenticator)를 호출하는 것으로 이 구상 서브 클래스의 인스턴스가 시스템에 등록됩니다. 인증이 필요한 경우, 시스템은 requestPasswordAuthentication() 메서드의 1개를 호출해, 이것이 등록된 객체의 getPasswordAuthentication() 메서드를 호출합니다.

인증을 요구하는 메서드는 모두, 실패에 끝나는 디폴트 구현을 가지고 있습니다.

도입된 버전 :

1.2

관련 항목:

setDefault(java.net.Authenticator), getPasswordAuthentication()

중첩(Nested) 클래스 개요

static class

Authenticator.RequestorType 인증을 요구하고 있는 엔티티의 타입

생성자 개요

Authenticator ()

메서드 개요

protected PasswordAuthentication	getPasswordAuthentication () 패스워드 인증이 필요한 경우에 호출합니다.
protected String	getRequestingHost () 인증을 요구하고 있는 사이트 또는 프록시의 hostname를 취득합니다.
protected int	getRequestingPort () 요구된 접속에 사용하는 포트 번호를 취득합니다.
protected String	getRequestingPrompt () 요구자가 입력한 prompt 캐릭터 라인을 취득합니다.
protected String	getRequestingProtocol () 접속을 요구하고 있는 프로토콜을 리턴합니다.
protected String	getRequestingScheme () 요구자가 사용하고 있는 방식 (예를 들어 HTTP 방화벽(fire wall)의 경우는 HTTP 방식)
protected InetAddress	getRequestingSite () 허가를 요구하고 있는 사이트의 InetAddress를 취득합니다.
protected URL	getRequestingURL () 이 인증 요구의 결과인 URL를 리턴합니다.
protected Authenticator.RequestorType	getRequestorType () 요구자가 프록시인가 서버인지를 리턴합니다.
static PasswordAuthentication	requestPasswordAuthentication (InetAddress addr, int port, String protocol, String prompt, String scheme) 시스템에 등록되어 있는 Authenticator에 패스워드를 요구합니다.
static PasswordAuthentication	requestPasswordAuthentication (String host, InetAddress addr, int port, String protocol, String prompt, String scheme) 시스템에 등록되어 있는 Authenticator에 패스워드를 요구합니다.
static PasswordAuthentication	requestPasswordAuthentication (String host, InetAddress addr, int port, String protocol, String prompt, String scheme, URL url, Authenticator.RequestorType reqType) 시스템에 등록되어 있는 Authenticator에 패스워드를 요구합니다.
static void	setDefault (Authenticator a) Authenticator를 설정합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

Authenticator

public Authenticator()

메서드의 상세

setDefault

public static void setDefault(Authenticator  a)

Authenticator를 설정합니다. 이 Authenticator는 프록시 서버 또는 HTTP 서버로부터 Authenticator가 요구되었을 때에 네트워크 코드가 사용합니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkPermission 메서드가 접근 권한 NetPermission("setDefaultAuthenticator")를 지정해 호출합니다. 이 결과, java.lang.SecurityException가 되는 일이 있습니다.

파라미터:

a - 설정되는 Authenticator. null인 경우, 이전으로 설정된 Authenticator는 모두 삭제된다

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 디폴트의 Authenticator를 설정하는 것을 허가하지 않는 경우

관련 항목:

SecurityManager.checkPermission(java.security.Permission), NetPermission

requestPasswordAuthentication

public static PasswordAuthentication  requestPasswordAuthentication(InetAddress  addr,
                                                                   int port,
                                                                   String  protocol,
                                                                   String  prompt,
                                                                   String  scheme)

시스템에 등록되어 있는 Authenticator에 패스워드를 요구합니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkPermission 메서드가 접근 권한 NetPermission("requestPasswordAuthentication")를 지정해 호출합니다. 이 결과, java.lang.SecurityException가 되는 일이 있습니다.

파라미터:

addr - 허가를 요구하고 있는 사이트의 InetAddress. InetAddress가 불명의 경우는 null

port - 요구된 접속에 사용하는 포트 번호

protocol - 접속을 요구하고 있는 프로토콜 (getRequestingProtocol() )

prompt - 사용자에 게 표시되는 prompt 캐릭터 라인

scheme - 인증 방식

반환값:

사용자 명 또는 패스워드. 취득할 수 없는 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 패스워드 인증 요구를 허가하지 않는 경우

관련 항목:

SecurityManager.checkPermission(java.security.Permission), NetPermission

requestPasswordAuthentication

public static PasswordAuthentication  requestPasswordAuthentication(String  host,
                                                                   InetAddress  addr,
                                                                   int port,
                                                                   String  protocol,
                                                                   String  prompt,
                                                                   String  scheme)

시스템에 등록되어 있는 Authenticator에 패스워드를 요구합니다. InetAddress를 사용할 수 없는 경우는 호스트명이 제공되므로 이 방법으로 패스워드를 요구하는 것을 추천합니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkPermission 메서드가 접근 권한 NetPermission("requestPasswordAuthentication")를 지정해 호출합니다. 이 결과, java.lang.SecurityException가 되는 일이 있습니다.

파라미터:

host - 인증을 요구하고 있는 사이트의 호스트명

addr - 인증을 요구하고 있는 사이트의 InetAddress. InetAddress가 불명의 경우는 null

port - 요구된 접속에 사용하는 포트 번호

protocol - 접속을 요구하고 있는 프로토콜 (getRequestingProtocol() )

prompt - 인증 영역을 식별하는 사용자에 게 표시되는 prompt 캐릭터 라인

scheme - 인증 방식

반환값:

사용자 명 또는 패스워드. 취득할 수 없는 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 패스워드 인증 요구를 허가하지 않는 경우

도입된 버전 :

1.4

관련 항목:

SecurityManager.checkPermission(java.security.Permission), NetPermission

requestPasswordAuthentication

public static PasswordAuthentication  requestPasswordAuthentication(String  host,
                                                                   InetAddress  addr,
                                                                   int port,
                                                                   String  protocol,
                                                                   String  prompt,
                                                                   String  scheme,
                                                                   URL  url,
                                                                   Authenticator.RequestorType  reqType)

시스템에 등록되어 있는 Authenticator에 패스워드를 요구합니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkPermission 메서드가 접근 권한 NetPermission("requestPasswordAuthentication")를 지정해 호출합니다. 이 결과, java.lang.SecurityException가 되는 일이 있습니다.

파라미터:

host - 인증을 요구하고 있는 사이트의 호스트명

addr - 허가를 요구하고 있는 사이트의 InetAddress. InetAddress가 불명의 경우는 null

port - 요구된 접속에 사용하는 포트 번호

protocol - 접속을 요구하고 있는 프로토콜 (getRequestingProtocol() )

prompt - 사용자에 게 표시되는 prompt 캐릭터 라인

scheme - 인증 방식

url - 인증을 발생시킨 요구원의 URL

reqType - 인증을 요구하고 있는 엔티티의 타입 (서버 또는 프록시)

반환값:

사용자 명 또는 패스워드. 취득할 수 없는 경우는 null

예외:

SecurityException - 시큐러티 매니저가 존재해, 시큐러티 매니저의 checkPermission 메서드가 패스워드 인증 요구를 허가하지 않는 경우

도입된 버전 :

1.5

관련 항목:

SecurityManager.checkPermission(java.security.Permission), NetPermission

getRequestingHost

protected final String  getRequestingHost()

인증을 요구하고 있는 사이트 또는 프록시의 hostname를 취득합니다. hostname를 사용할 수 없는 경우는 null이 리턴됩니다 .

반환값:

인증을 요구하고 있는 접속의 호스트명. 호스트명을 사용할 수 없는 경우는 null

도입된 버전 :

1.4

getRequestingSite

protected final InetAddress  getRequestingSite()

허가를 요구하고 있는 사이트의 InetAddress를 취득합니다. InetAddress를 사용할 수 없는 경우는 null이 리턴됩니다 .

반환값:

인증을 요구하고 있는 사이트의 InetAddress. InetAddress를 사용할 수 없는 경우는 null

getRequestingPort

protected final int getRequestingPort()

요구된 접속에 사용하는 포트 번호를 취득합니다.

반환값:

요구된 접속의 포트 번호를 나타내는 int

getRequestingProtocol

protected final String  getRequestingProtocol()

접속을 요구하고 있는 프로토콜을 리턴합니다. 많은 경우, 프로토콜은 URL를 기본으로 하고 있습니다. 그러나 장래의 JDK 에서는 예를 들어 패스워드로 보호된 SOCKS5 방화벽(fire wall)에는 「SOCKS」라고 지정하게 될 예정입니다.

반환값:

프로토콜. 버전 번호를 나타내는 「/version」가 뒤를 뒤따르는 일도 있는

관련 항목:

URL.getProtocol()

getRequestingPrompt

protected final String  getRequestingPrompt()

요구자가 입력한 prompt 캐릭터 라인을 취득합니다.

반환값:

요구자가 입력한 prompt 캐릭터 라인 (http 요구를 위한 영역)

getRequestingScheme

protected final String  getRequestingScheme()

요구자가 사용하고 있는 방식 (예를 들어 HTTP 방화벽(fire wall)의 경우는 HTTP 방식)

반환값:

요구자가 사용하고 있는 방식

getPasswordAuthentication

protected PasswordAuthentication  getPasswordAuthentication()

패스워드 인증이 필요한 경우에 호출합니다. 서브 클래스에서는 디폴트의 구현을 오버라이드(override) 할 필요가 있습니다. 디폴트의 구현에서는 null이 리턴됩니다 .

반환값:

사용자 로부터 수집한 PasswordAuthentication. 없는 경우에는 null

getRequestingURL

protected URL  getRequestingURL()

이 인증 요구의 결과인 URL를 리턴합니다.

반환값:

요구원의 URL

도입된 버전 :

1.5

getRequestorType

protected Authenticator.RequestorType  getRequestorType()

요구자가 프록시인가 서버인지를 리턴합니다.

반환값:

요구자의 인증 타입

도입된 버전 :

1.5