Dell N3200-ON Networking N-Series Switches RESTful API User Guide version 6.8. - Page 19

Authentication Login Implements a RESTful API providing user authentication and authorization. A user session is required for all RESTful API requests. A user session is established by logging in with a valid username and password. Upon successful login, a session identifier (SID) is returned. Use this SID with all future requests. When you are finished with your session, logout. A successful logout request deletes the SID and invalidates the session. Note that the SID will automatically be deleted if the hard or soft time-out is exceeded. The username, password, and switch access level, as well as the session time-out parameters, are managed by your system administrator. It is recommended that you always use HTTPS to ensure security. Login CREATE POST /open/v1/login Use this call to create a login session. Upon successful login, a user SID (or SIDSSL for HTTPS) is returned. Use this SID for future requests until you are done with the session by logging out. Note that while the login feature provides access control to the switch over HTTP connections, it does not provide security. This is because the SID is sent as cleartext over HTTP. A spoofer listening for packets can determine the SID and issues requests to the switch through the RESTful API using the same SID. For security, HTTPS is a better choice. Request Details Table 4-5. Login CREATE Request Details Parameter username password Type String String Description User name or identifier. User password. Rest API Reference 19