enum URLSession.AuthChallengeDisposition
The session containing the task whose request requires authentication. それのリクエストが認証を要請するタスクを含んでいるセッション。
Availability 有効性
Technology
optional func urlSession(_ session: URLSession
,
task: URLSessionTask
,
didReceive challenge: URLAuthenticationChallenge
,
completionHandler: @escaping (URLSession
.AuthChallengeDisposition
, URLCredential
?) -> Void
)
session
The session containing the task whose request requires authentication. それのリクエストが認証を要請するタスクを含んでいるセッション。
task
The task whose request requires authentication. それのリクエストが認証を要請するタスク。
challenge
An object that contains the request for authentication. 認証に対する要請を含んでいるオブジェクト。
completionHandler
A handler that your delegate method must call. Its parameters are: あなたの委任先メソッドが呼び出す必要があるハンドラ。それのパラメータは:
disposition
—One of several constants that describes how the challenge should be handled.
disposition
— いくつかの定数のうちの1つ、それはどのようにチャレンジが取り扱われるべきかを記述します。
credential
—The credential that should be used for authentication if disposition is NSURLSession
; otherwise, NULL
.
credential
— 資格情報、それは認証に使われるべきです、もし意向がNSURLSession
であるならば;そうでなければ、NULL
。
Concurrency Note 並行性注意
You can call this method from synchronous code using a completion handler, as shown on this page, or you can call it as an asynchronous method that has the following declaration: あなたは、このメソッドを同期コードから完了ハンドラを使って呼び出せます、このページで示されるように、またはあなたはそれを以下の宣言を持つ非同期メソッドとして呼び出せます:
For information about concurrency and asynchronous code in Swift, see Calling Objective-C APIs Asynchronously. Swiftにおける並行性と非同期コードについての情報として、Objective-C APIを非同期に呼び出すを見てください。
This method handles task-level authentication challenges. The URLSession
protocol also provides a session-level authentication delegate method. The method called depends on the type of authentication challenge:
このメソッドは、タスク水準認証チャレンジを取り扱います。URLSession
プロトコルはまた、セッション水準認証委任先メソッドを提供します。呼び出されるメソッドは、認証チャレンジの型に依存します:
For session-level challenges—NSURLAuthentication
, NSURLAuthentication
, NSURLAuthentication
, or NSURLAuthentication
—the NSURLSession
object calls the session delegate’s url
method.
セッション水準チャレンジ — NSURLAuthentication
、NSURLAuthentication
、NSURLAuthentication
、またはNSURLAuthentication
— に対して、NSURLSession
オブジェクトは、セッション委任先のもつurl
メソッドを呼び出します。
If your app does not provide a session delegate method, the NSURLSession
object calls the task delegate’s url
method to handle the challenge.
For non-session-level challenges (all others), the URLSession
object calls the session delegate’s url
method to handle the challenge. If your app provides a session delegate and you need to handle authentication, then you must either handle the authentication at the task level or provide a task-level handler that calls the per-session handler explicitly. The session delegate’s url
method is not called for non-session-level challenges.
非セッション水準チャレンジ(他の全て)に対して、URLSession
オブジェクトは、セッション委任先のもつurl
メソッドを呼び出して、チャレンジを取り扱います。あなたのアプリがセッション委任先を提供するそしてあなたが認証を取り扱う必要があるならば、そのときあなたは認証をタスク水準で取り扱うまたはセッションごとのハンドラを明示的に呼び出すタスク水準ハンドラを提供するのどちらかをしなければなりません。セッション委任先のもつurl
メソッドは、非セッション水準チャレンジに対して呼び出されません。
enum URLSession.AuthChallengeDisposition