POST Codesign/CreateProject
Creates an empty CodeSign Protect Project. After you create the project, use the CodeSign Protect MMC to add environments or POST Codesign/UpdateProject.
- Signing Project settings are configurable via this REST API and in the VCC.
- A project can also use settings from the global configuration.
- After a project is approved, it is ready for code signing.
- Administrators can monitor signing progress from the Codesigning UI.
- A project has one or more collections, which are references, about signing applications or tools.
- A project has one or more Environments and roles which are also known as rights.
- Each environment references a template. The Environment also has certificates or keys and a signing flow. The signing flow regulates the progress of application signing via a client. For more information, see Flow API.
Requirements
- Permissions: None. Projects are created in a Draft state and cannot be used until approved by an administrator.
- Token scope: Codesign:Manage
Headers
-
Content type: Content-Type:application/json.
- Token: The bearer access token that you received. For example, Authorization:Bearer 4MyGeneratedBearerTknz==. For more information, see Passing a bearer token in your API calls.
Parameters
Name |
Description |
---|---|
Dn |
The Distinguished Name (DN) of the signing project. Use the appropriate syntax. For example, in Postman: \\VED\\Code Signing\\Projects\\[YourPrjName]. |
Returns
Name |
Description |
---|---|
HTTP 200 |
For valid requests, this call returns a HTTP 200 message and the following data in the message body:
|
HTTP 400 |
For invalid requests, this call returns HTTP 400 Bad Request and the following data in the message body:
|
Example: Create an empty project
Request
POST https://codesign.venafi.example/vedsdk/Codesign/CreateProject Authorization:Bearer 4MyGeneratedBearerTknz== { "Dn":"\\VED\\Code Signing\\Projects\\RESTProjectwithSignProject" }
Response
HTTP/1.1 200 OK { "Project":{ "ApplicationDNs":{ "Items":[ ] }, "Applications":[ ], "Auditors":{ "Items":[ ] }, "CSPEnvironments":[ ], "CertificateEnvironments":[ ], "Collections":[ ], "CreatedOn":"/Date(1631810319796)/", "CustomFieldAttributes":{ "Items":[ ] }, "Dn":"\\VED\\Code Signing\\Projects\\RESTProjectwithSignProject", "DotNetEnvironments":[ ], "GPGEnvironments":[ ], "Guid":"{a6f67184-021e-45da-acd6-397d30286131}", "Id":648, "KeyUseApprovers":{ "Items":[ ] }, "KeyUsers":{ "Items":[ ] }, "Owners":{ "Items":[ "local:{427d5bf3-00e9-4572-bbfb-cd1ea44838f0}" ] }, "Status":2 }, "Result":1, "Success":true }