## 全局安全配置
OpenAPI支持的方案包括基本身份驗證、API密鑰(作為頭或作為查詢參數)和OAuth2的公共流(隱式、密碼、應用程序和訪問代碼)。在Swagger中使用```@SWG\SecurityScheme```定義全局安全配置。
用法如下:
```
/**
* @SWG\SecurityScheme(securityDefinition="apikey",type="apiKey",name="apikey",in="header"),
* /
```
| 參數 | 含義 |
| --- | --- |
| securityDefinition | swager->securityDefinitions數組中的鍵 |
| type | 類型 值為 basic、apiKey、oauth2 |
| name | 名稱 |
| in | 需要API密鑰的位置 值為 query、header |
| flow | OAuth2安全方案使用的流 值為:“implicit”、“password”、“application”或“accesscode” |
| authorizationUrl | OAuth2授權URL |
| scopes | OAuth2安全方案的可用范圍 |
apikey示例:
```
/**
*@SWG\SecurityScheme(securityDefinition="apikey",type="apiKey",name="apikey",in="header"),
*/
```
OAuth2示例:
```
/**
*@SWG\SecurityScheme(securityDefinition="auth",type="oauth2",name="auth",scopes={"write:pets"="modify pets in your account","read:pets"="read your pets"},flow="implicit",authorizationUrl="http://swagger.io/api/oauth/dialog")
* /
```