
# 认证登录获取授权码 - IssueOIDCAuthCode
#### 功能介绍
用户访问集成应用时，应用向OneAccess发起授权登录请求（重定向方式），用户输入用户密码认证成功后，OneAccess将重定向回应用，并携带授权码code参数。
#### URI
GET /api/v1/oauth2/authorize
表1Query参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                 |
|:---|:---|:---|:---|
| client_id     | 是    | String | 应用标识，注册应用后，分配的ClientId。                                            |
| redirect_uri  | 否    | String | 回调地址，表示应用接收OneAccess授权码的地址。地址可以是注册应用时填写的回调地址，也可以是注册应用时填写的回调地址的域名。  |
| response_type | 是    | String | 授权类型，固定值：code。                                                     |
| scope         | 否    | String | 授权范围，固定值：openid。                                                   |
| state         | 否    | String | 应用的状态值。可用于防止CSRF攻击，成功授权后回调应用时会原样带回，应用用它校验认证请求与回调请求的对应关系。可以包含字母和数字。 |
#### 请求参数
无
#### 响应参数
**状态码：302**
表2响应Header参数 
| 参数       | 参数类型   | 描述                                                         |
|:---|:---|:---|
| Location | String | 认证登录成功，重定向地址。例：https://example.com?code=z2D...\&state=test |
   
#### 请求示例
获取OIDC授权码。授权类型为固定值code，配置应用注册时生成的clientId，成功授权后的回调地址为https://example.com，授权范围为固定值openid。
```
GET https://{domain_name}/api/v1/oauth2/authorize?response_type=code&client_id=cU0L3GsEq1vuOJ5iQrRSu5AyPnKL8...&redirect_uri=https://example.com&scope=openid&state=test
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述                                                                                          |
|:---|:---|
| 302 | 用户未登录，跳转用户登录页面。用户已登录，携带授权码重定向到redirect_uri地址。例：https://example.com?code=z2D...\&state=test。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-oneaccess/ErrorCode.html)。
