Instance Method インスタンスメソッド

download(_:didReceive:)

Sent when the URL download must authenticate a challenge in order to download the request. URLダウンロードがリクエストをダウンロードする手段としてあるチャレンジを認証しなければならない時に送られます。

Declaration 宣言

optional func download(_ download: NSURLDownload, 
            didReceive challenge: URLAuthenticationChallenge)

Parameters パラメータ

download

The URL download object sending the message. メッセージを送っているURLダウンロードオブジェクト。

challenge

The URL authentication challenge that must be authenticated in order to download the request. リクエストをダウンロードするために認証されなければならないURL認証チャレンジ。

Discussion 議論

This method gives the delegate the opportunity to determine the course of action taken for the challenge: provide credentials, continue without providing credentials or cancel the authentication challenge and the download. このメソッドが委任先に与えるのは、チャレンジに対して取る行動の仕方:資格情報を与える、資格情報を与えることなく続けるまたは認証チャレンジとダウンロードをキャンセルする、を決定する機会です。

The delegate can determine the number of previous authentication challenges by sending the message previousFailureCount to challenge. 委任先は、以前の認証チャレンジの数を、メッセージpreviousFailureCountchallengeに送ることによって決定できます。

If the previous failure count is 0 and the value returned by proposedCredential is nil, the delegate can create a new NSURLCredential object, providing information specific to the type of credential, and send a use(_:for:) message to [challenge sender], passing the credential and challenge as parameters. If proposedCredential is not nil, the value is a credential from the URL or the shared credential storage that can be provided to the user as feedback. 以前の失敗合計が0であるそしてproposedCredentialによって返される値がnilであるならば、委任先は新しいNSURLCredentialオブジェクトを作成できます、資格情報の型を指定する情報を提供して、そしてuse(_:for:)メッセージを[challenge sender]に送ります、資格情報とchallengeをパラメータとして渡して。proposedCredentialnilでないならば、値はURLからのまたはユーザにフィードバックとして提供されることができる共有資格情報ストレージからの資格情報です。

The delegate may decide to abandon further attempts at authentication at any time by sending [challenge sender] a continueWithoutCredential(for:) or a cancel(_:) message. The specific action is implementation dependent. 委任先は、より一層の認証の試みを、[challenge sender]continueWithoutCredential(for:)またはcancel(_:)メッセージを送ることによって、いつ何時放棄するよう決定するかもしれません。詳細な動作は、実装依存です。

If the delegate implements this method, the download will suspend until [challenge sender] is sent one of the following messages: use(_:for:), continueWithoutCredential(for:) or cancel(_:). 委任先がこのメソッドを実装するならば、ダウンロードは[challenge sender]が以下のメッセージの1つを送られるまで待機します:use(_:for:)continueWithoutCredential(for:)またはcancel(_:)

If the delegate does not implement this method the default implementation is used. If a valid credential for the request is provided as part of the URL, or is available from the NSURLCredentialStorage the [challenge sender] is sent a use(_:for:) with the credential. If the challenge has no credential or the credentials fail to authorize access, then continueWithoutCredential(for:) is sent to [challenge sender] instead. 委任先がこのメソッドを実装しないならば省略時の実装が使われます。リクエストに対して有効な資格情報がURLの一部として提供される、またはNSURLCredentialStorageから利用可能ならば、[challenge sender]は、use(_:for:)をその資格情報とともに送られます。チャレンジが資格情報を持たないまたはその資格情報がアクセスの認可に失敗するならば、そのときcontinueWithoutCredential(for:)が代わりに[challenge sender]に送られます。

See Also 参照

Download Authentication ダウンロード認証