访问需要HTTP认证的API

很多时候,我们需要对访问的URL进行安全验证。我们通过这段向大家介绍如何通过Alamofire访问需要HTTP简单认证的URL。


服务端的准备

首先我们要在服务端添加一个需要安全验证的HTTP API,基于我们上一个的例子,打开routes.php,添加下面的代码:


Route::group(['middleware' => ['api']], function () {
    Route::get('/alamofire', 'AlamofireController@index');

    Route::post('/alamofire', [
            'middleware' => 'auth.basic.once', 
            'uses' => 'AlamofireController@store']);
});

这里,我们定义了一个auth.basic.once middleware,用于完成一个无状态的HTTP简单认证。我们来实现它。

在Terminal里,进入apidemo的项目目录,执行下面的命令创建一个middleware:


php artisan make:middleware AuthenticateOnceWithBasicAuth

然后,Laravel会在app/Http/Middleware目录为我们创建一个AuthenticateOnceWithBasicAuth.php,里面会包含一个同名的class。在它的Handle方法里,我们添加下面的代码:


/**
 * Handle an incoming request.
 *
 * @param  \Illuminate\Http\Request  $request
 * @param  \Closure  $next
 * @return mixed
 */
public function handle($request, Closure $next)
{
    return Auth::onceBasic() ?: $next($request);
}

在这里Auth::onceBasic()为我们执行一次无状态的HTTP简单认证(它不会在session里写上),如果它没有返回值,则代表认证成功,我们可以把请求转发到后续的处理逻辑。否则,我们就返回Auth::onceBasic()提供的错误信息。

完成之后,我们打开app/Http/Kernel.php,注册我们之间添加的中间件:


/**
 * The application's route middleware.
 *
 * These middleware may be assigned to groups or used individually.
 *
 * @var array
 */
protected $routeMiddleware = [
    // omit for simplicity

    'auth.basic.once' => \App\Http\Middleware\AuthenticateOnceWithBasicAuth::class
];

这样当我们发起POST请求到/alamofire的时候,服务器就会要求认证。为了测试,我们添加一个用户帐号。

首先,在config/database.php里,我们把默认的数据库修改成sqlite(当然,在.env里添加环境变量也可以):


'default' => env('DB_CONNECTION', 'sqlite'),

然后,在terminal里执行:


php artisan migrate

这样,Laravel就会在sqlite里创建users表,然后,执行下面的命令:


php artisan tinker

这样,我们就进入了tinker的控制台,在这里执行下面的代码:


App\User::create([
    'email' => '11@boxue.io', 
    'password' => bcrypt('boxue'), 
    'name' => '11']);

image

这样,我们就向数据库中添加了一条User记录。

最后,我们修改一下AlamofireController中处理POST /alamofire的代码:


/**
 * Store a newly created resource in storage.
 *
 * @param  \Illuminate\Http\Request  $request
 * @return \Illuminate\Http\Response
 */
public function store(Request $request)
{
    //
    $data = $request->all();

    return response()->json([
        'status' => 'successful',
        'data' => $data], 201);
}

接下来,我们使用POSTMAN验证一下。


使用Postman

POSTMAN是一个Chrome app,可以很方便的帮我们测试各种HTTP API。我们可以在Chrome extension中找到它。它有两个版本,一个是Chrome插件版,这个版本在Canary上有些问题;还有一个是Chrome app,这里推荐大家使用app版。

image

打开POSTMAN,按照下图中填写我们的HTTP API信息:

image

当我们选择HTTP basic auth的时候,POSTMAN会自动为我们生成响应HTTP header:

image

然后,我们随便填写一个POST BODY:

image

设置完成后,点击"Send"按钮,我们就可以看到返回的Status是201,内容是我们返回的JSON。

image

如果我们把密码改成一个错误的值(例如下图:),然后重新发送请求,就可以看到服务器返回的401 - invalid credentials错误了。

image

在服务端搞定认证之后,接下来,我们来看如何用Alamofire替代POSTMAN发送请求。


使用Alamofire完成请求

在搞定了前面的各种配置和代码之后,用Alamofire发送请求倒是显得格外简单。我们有两种不同的方法可以通过Alamofire访问需要HTTP简单认证的API。

调用authenticate方法

这是最简单的方法,Alamofire有一个authenticate方法,我们直接拿来用就可以了:

回到Xcode,在ViewDidLoad方法里,添加下面的代码:


let user = "11@boxue.io"
let pw = "boxue"

Alamofire.request(.POST, "https://apidemo.boxue.io/alamofire")
    .authenticate(user: user, password: pw)
    .responseJSON(completionHandler: { response in
        debugPrint(response)
    })

按Command + R,就可以在控制台,看到了对应的结果了:

image

除了给authenticate传递用户名和密码外,我们还可以传给它传递一个NSURLCredential对象:


let user = "11@boxue.io"
let pw = "boxue"
let credential = NSURLCredential(user: user, 
                             password: pw, 
                          persistence: .ForSession)

Alamofire.request(.POST, "https://apidemo.boxue.io/alamofire")
    .authenticate(usingCredential: credential)
    .responseJSON(completionHandler: { response in
        debugPrint(response)
    })

按Command + R,重新编译执行,我们就可以在控制台里看到,结果是一样的。


自行构造HTTP header

除了使用authenticate方法之外,我们也可以手工构造一个和POSTMAN一样的HTTP header,用于HTTP basic authentication:


let credentialData = 
    "\(user):\(pw)".dataUsingEncoding(NSUTF8StringEncoding)!
let base64Credentials = 
    credentialData.base64EncodedStringWithOptions([])

let headers = ["Authorization": "Basic \(base64Credentials)"]

然后,我们把这个header添加到POST请求就可以了:


Alamofire.request(.POST, 
    "https://apidemo.boxue.io/alamofire", 
    headers: headers)
    .responseJSON(completionHandler: { response in
        debugPrint(response)
    })

按Command + R,重新编译执行,我们就可以在控制台里看到,结果是一样的。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 220,492评论 6 513
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,048评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 166,927评论 0 358
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,293评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,309评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,024评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,638评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,546评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,073评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,188评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,321评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,998评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,678评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,186评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,303评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,663评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,330评论 2 358