## 安全 要確定某個特定操作使用哪個安全機制，使用`@ApiSecurity()`裝飾器。 ```TypeScript @ApiSecurity('basic') @Controller('cats') export class CatsController {} ``` 在運行程序前，使用`DocumentBuilder`在基礎文檔里添加安全定義。 ```TypeScript const options = new DocumentBuilder().addSecurity('basic', { type: 'http', scheme: 'basic', }); ``` 一些最常用的認證機制是內置的(例如`basic`和`bearer`),因此不需要像上面那樣手動定義。 ### `Basic`認證 使用`@ApiBasicAuth()`配置basic認證。 ```TypeScript @ApiBasicAuth() @Controller('cats') export class CatsController {} ``` 在運行程序前，使用`DocumentBuilder`在基礎文檔里添加安全定義。 ```TypeScript const options = new DocumentBuilder().addBasicAuth(); ``` ### Bearer認證 使用`@ApiBearerAuth()`啟用bearer認證。 ```TypeScript @ApiBearerAuth() @Controller('cats') export class CatsController {} ``` 在運行程序前，使用`DocumentBuilder`在基礎文檔里添加安全定義。 ```TypeScript const options = new DocumentBuilder().addBearerAuth(); ``` ### OAuth2認證 使用`@ApiOAuth2()`啟用OAuth2認證。 ```TypeScript @ApiOAuth2(['pets:write']) @Controller('cats') export class CatsController {} ``` 在運行程序前，使用`DocumentBuilder`在基礎文檔里添加安全定義。 ```TypeScript const options = new DocumentBuilder().addOAuth2(); ``` ### Cookie認證 使用`@ApiCookieAuth()`啟用cookie認證。 ```TypeScript @ApiCookieAuth() @Controller('cats') export class CatsController {} ``` 在運行程序前，使用`DocumentBuilder`在基礎文檔里添加安全定義。 ```TypeScript const options = new DocumentBuilder().addCookieAuth('optional-session-id'); ```