{"type":"api","title":"Update list of remote RADIUS servers","meta":{"id":"/apps/pubhub/media/crosswork-network-controller-7-1/f445c17e25a1120e8fbde4bd413083d0fd88b2b3/5e144619-25b2-30e4-9a1e-a368d8dadee6","info":{"title":"Crosswork Remote Authentication Server Integration API - Version 1","contact":{"name":"Crosswork Team, Cisco","email":"support@cisco.com"},"license":{"name":"Cisco Software License Agreement","url":"http://www.cisco.com/public/sw-license-agreement.html"},"version":"1.0.0","description":"APIs to support integration of the Crosswork platform and remote authentication servers. TACACS+, LDAP, RADIUS, SSO server types are supported."},"security":[{"bearerAuth":[]}],"x-parser-conf":{"overview":{"markdownPath":"reference/INFRA/RBAC/auth-remote-v1-overview.md"}},"swagger":"2.0","basePath":"/crosswork/authconfig/v1","schemes":["https"],"securityDefinitions":{"bearerAuth":{"type":"apiKey","name":"Authorization","in":"header","description":"Use a bearer token to authenticate requests. Include the token in the Authorization header with the prefix 'Bearer '."}}},"spec":{"summary":"Update list of remote RADIUS servers","description":"Update the list of RADIUS servers that were configured to integrate with Crosswork. The updated list will overwrite the current list of RADIUS servers. To delete a given RADIUS server, simply remove it from the body payload. To add a new RADIUS server, add it to the existing list of servers in the body payload.","operationId":"UpdateAllRadius","consumes":["application/json"],"produces":["application/json"],"responses":{"204":{"description":"No Content. The request was successful and there is no additional content in the response body.","schema":{"type":"object","properties":{"example":{"type":"array"}},"example":{"name":{"type":"string","description":"No Content"}},"$$ref":"#/definitions/authconfigEmpty"}},"403":{"description":"Forbidden. The server recognizes the authentication credentials, but the client is not authorized to perform this request."},"422":{"description":"Unprocessable Entity. The server understands the content type of the request entity, and the syntax of the request entity is correct, but it was unable to process the contained instructions."},"500":{"description":"Internal Server Error. The server could not fulfill the request."}},"parameters":[{"name":"body","in":"body","required":true,"schema":{"type":"object","properties":{"radius_servers":{"type":"array","items":{"type":"object","required":["host","port","secret","secretFormat","retries","authType","priority"],"properties":{"host":{"type":"string","description":"IP Address or hostname"},"port":{"type":"integer","description":"The port number on which the radius server is listening (default is typically 49)."},"secret":{"type":"string","description":"Shared secret"},"secretFormat":{"type":"string","enum":["ascii","hex"],"description":"Shared secret format","$$ref":"#/definitions/secretFormatType"},"timeout":{"type":"integer","description":"The re-transmit timeout for requests to the radius server."},"retries":{"type":"integer","description":"The number of times to retry a request to the radius server before failing."},"authType":{"type":"string","enum":["pap","chap"],"description":"Authentication type","$$ref":"#/definitions/authTypeEnum"},"priority":{"type":"integer","description":"The priority of this server in a list of multiple remote servers"},"policyId":{"type":"string","description":"Key name for role ID configured on the RADIUS server"}},"$$ref":"#/definitions/authconfigRadiusServer"},"example":[{"host":"1.2.3.4","port":49,"secret":"secret","secretFormat":"secretFormat","timeout":1,"retries":0,"authType":"pap","priority":11,"policyId":"policyx"}]}},"$$ref":"#/definitions/authconfigRadiusServers"},"description":"application/json"}],"tags":["authconfig"],"__originalOperationId":"UpdateAllRadius","security":[{"bearerAuth":[]}],"method":"put","path":"/remote/radius"}}