java.net
클래스 Authenticator

java.lang.Object 
  |
  +--java.net.Authenticator

public abstract class Authenticator

extends Object

Authenticator 클래스는 네트워크 접속에 필요한 인증을 취득하기 위한 오브젝트를 나타냅니다. 통상은 유저에게 정보의 입력을 요구하는 것으로, 인증을 실시합니다.

어플리케이션으로 이 클래스를 사용하려면 , 서브 클래스를 작성해, SetDefault()를 사용해 시스템에 서브 클래스의 인스턴스를 등록합니다. 인증이 요구되면(자), 시스템은 서브 클래스의 메소드 (getPasswordAuthentication 등)를 호출합니다. 서브 클래스의 메소드는 다수의 계승된 메소드 (getRequesting 로 시작되는 메소드)를 사용해, 요구된 인증에 대해 조회를 실시할 수가 있습니다. 그 후로, 유저에게 표시하는 적절한 메세지를 형성할 수 있습니다.

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

도입된 버젼:

1.2

관련 항목:

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

생성자의 개요

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 를 취득합니다.
static PasswordAuthentication	requestPasswordAuthentication (InetAddress addr, int port, String protocol, String prompt, String scheme) 시스템에 등록되어 있는 오센티케이타에, 패스워드를 요구합니다.
static PasswordAuthentication	requestPasswordAuthentication (String host, InetAddress addr, int port, String protocol, String prompt, String scheme) 시스템에 등록되어 있는 오센티케이타에 패스워드를 요구합니다.
static void	setDefault (Authenticator a) 오센티케이타를 설정합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

Authenticator

public Authenticator()

메소드의 상세

setDefault

public static void setDefault(Authenticator  a)

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

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkPermission 메소드가, 액세스권 NetPermission("setDefaultAuthenticator") 를 지정해 불려 갑니다. 이 결과, java.lang.SecurityException 가 되는 일이 있습니다.

파라미터:

a - 설정되는 오센티케이타. null 의 경우, 이전으로 설정된 오센티케이타는 모두 삭제된다

예외:

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

관련 항목:

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

requestPasswordAuthentication

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

시스템에 등록되어 있는 오센티케이타에, 패스워드를 요구합니다.

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 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)

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

시큐러티 매니저가 존재하는 경우, 최초로 시큐러티 매니저의 checkPermission 메소드가, 액세스권 NetPermission("requestPasswordAuthentication") 를 지정해 불려 갑니다. 이 결과, java.lang.SecurityException 가 되는 일이 있습니다.

파라미터:

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

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

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

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

prompt - 인증 area를 식별하는 유저에게 표시되는 prompt 캐릭터 라인

scheme - 인증 방식

반환값:

유저명 또는 패스워드. 취득할 수 없는 경우는 null

예외:

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

도입된 버젼:

1.4

관련 항목:

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 를 기본으로 하고 있습니다. 그러나 장래의 SDK 에서는 예를 들어, 패스워드로 보호된 SOCKS5 파이어 월(fire wall)에는 「SOCKS」라고 지정하게 될 예정입니다.

반환값:

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

관련 항목:

URL.getProtocol()

getRequestingPrompt

protected final String  getRequestingPrompt()

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

반환값:

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

getRequestingScheme

protected final String  getRequestingScheme()

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

반환값:

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

getPasswordAuthentication

protected PasswordAuthentication  getPasswordAuthentication()

패스워드 인증이 필요한 경우에 불려 갑니다. 서브 클래스에서는 디폴트의 구현을 오버라이드(override) 할 필요가 있습니다. 디폴트의 구현에서는 null 가 돌려주어집니다.

반환값:

유저로부터 수집한 PasswordAuthentication. 지정되어 있지 않은 경우는 null