NativeScript-SSL-Pinning

默认 http 模块的替代品。

注意：此插件受 nativescript-ssl-pinning 的启发。大部分代码来自此。我添加了 angular 支持，并修复了一些长期问题。向原始创建者表示衷心感谢。

以下是一些已修复的问题：

• 不支持通配符证书。
• nativescript-https 模块未处理任何错误响应（400 - 500）。
• 开箱即用的 angular 支持，无需更新旧应用程序，只需更新 HttpClient 模块导入。
• 添加了对 multipart 表单的支持。

功能

• 现代 TLS & SSL 安全功能
• 共享连接池减少请求延迟
• 静默恢复常见的连接问题
• 所有操作都在原生后台线程上运行
• 透明的 GZIP
• HTTP/2 支持

常见问题解答

SSL 固定是什么？以及所有这些安全术语是什么意思？

如何使用 SSL 固定使您的应用程序更安全.

我必须使用 SSL 固定吗？

不。 此插件开箱即用，无需任何安全配置即可运行。无论如何，您仍然可以受益于上述所有功能。

演示

git clone https://github.com/sai-gmbh/nativescript-ssl-pinning
cd nativescript-ssl-pinning/src
npm run demo.ios
npm run demo.android
npm run demo-angular.ios
npm run demo-angular.android

安装

将 tns-platform-declarations 添加到您的 references.d.ts 中，以支持 Android 和 iOS！

/// <reference path="./node_modules/tns-platform-declarations/android.d.ts" />
/// <reference path="./node_modules/tns-platform-declarations/ios.d.ts" />

我们还建议将 "skipLibCheck": true, 添加到您的 tsconfig.json 中。有关更多信息，请参阅 此处。

安装插件

tns plugin add nativescript-ssl-pinning

示例

使用 GET 方法调用 API

import { SslPinning } from 'nativescript-ssl-pinning'
SslPinning.request({
	url: 'https://httpbin.org/get',
	method: 'GET',
})
.then((response) => console.log('response', response))
.catch((error) => console.error('error', error));

Angular 支持

NativescriptSslPinningHttpClientModule 内部覆盖 Angular 的 XHRBackend 以通过我们的 SSL 插件发出请求，并将其转换回 angular 响应。这将保持拦截器功能完好无损。

import {NativescriptSslPinningHttpClientModule} from "nativescript-ssl-pinning/angular"
@NgModule({
  imports: [
    // ...
    NativescriptSslPinningHttpClientModule
  ],
  declarations: [
    ExampleComponent,
  ],
  schemas: [
    NO_ERRORS_SCHEMA
  ]
})
export class AppModule {
}

@Component({...})
export class ExampleComponent implements OnInit {
  constructor(private http: HttpClient) {}
  
  ngOnInit() {
    this.http.get('https://httpbin.org/status/500').subscribe(res => console.log(res), err => console.log(err));
  }
}

配置

安装您的 SSL 证书

在项目的 app 文件夹中创建一个名为 assets 的文件夹，例如 <project>/app/assets。

启用 SSL 固定

import { knownFolders } from 'file-system'
import { SslPinning } from 'nativescript-ssl-pinning'
let dir = knownFolders.currentApp().getFolder('assets')
let certificate = dir.getFile('httpbin.org.cer').path
SslPinning.enableSSLPinning({ host: 'httpbin.org', certificate })

一旦启用了 SSL 固定，您就不能使用不同的 host 或 certificate 文件重新启用。

禁用 SSL 固定

import { SslPinning } from 'nativescript-ssl-pinning'
SslPinning.disableSSLPinning()

调用此方法之后的所有请求将不再使用 SSL 固定，直到再次启用。

选项

export interface HttpsSSLPinningOptions {
	host: string
	certificate: string
	allowInvalidCertificates?: boolean
	validatesDomainName?: boolean
}

Webpack / 打包

由于您可能将证书与您的应用程序一起分发，因此请确保它也被 Webpack 打包。您可以通过添加证书（s）与 CopyWebpackPlugin 来完成此操作。

new CopyWebpackPlugin([
    { from: { glob: "fonts/**" } },
    { from: { glob: "**/*.jpg" } },
    { from: { glob: "**/*.png" } },
    { from: { glob: "**/*.cer" } },  // add this line in webpack.config.js
], { ignore: [`${relative(appPath, appResourcesFullPath)}/**`] })

iOS 故障排除

在开始加强之前，请先了解一下 iOS 的 App Transport Security。

如果您尝试访问一个未添加到App Transport Security白名单的https路由，它将无法工作！您可以通过在项目的Info.plist中添加以下内容来绕过这种行为：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

此插件不会自动将NSAllowsArbitraryLoads添加到您的项目的Info.plist中。

Android故障排除

如果您的应用程序崩溃并显示它在主线程上执行了过多的网络操作，那么请将具有值true的选项allowLargeResponse传递给request函数。

当前问题

1. 插件目前不支持多部分表单请求。对于Angular用户，它们将通过Angular自己的XHR进行，但对于本地用户可能会失败。

感谢