Content
View differences
Updated by Dominic Bräunlein almost 2 years ago
**As** a administrator responsible for storages
**I want to** trigger a test of the connection to an OneDrive/SharePoint external storage
**so that** I can verify if the storages works as expected and get helpful feedback otherwise.
**Acceptance criteria**
* A button allows for a manual trigger of a connection test and validation of the settings of a OneDrive/SharePoint storage. settings.
* If an error raises during the test, it is shown with an explanation and helpful information.
* If the test and validations are successful, it is clearly communicated to the user.
* Validations:
* The external storage server is reachable
* The oAuth2 settings are valid
* The Drive Id and tenant Id is valid
* When "automatically managed project folders" is activated in the management section, the drive needs to be empty
**Additional info**
* The "Validate/Test Connection" is quite independent from the Health status.
* Health status is only relevant for Storages with automatically managed project folders
* Test connection relates to all storages
* Validation messages
* **not configured**
* UI text: The connection could not be validated. Please finish configuration first.
* **drive id wrong**
* UI text: The configured drive id could not be found. Please check the configuration.
* Internal error: `code=>"itemNotFound", :message=>"Item not found"`
* **tenant id wrong**
* UI text: The configured directory (tenant) id is invalid. Please check the configuration.
* Payload: "AADSTS90002: Tenant 'e36f1dbc-fdae-427e-b61b-0d96ddfb81a5' not found. Check to make sure you have the correct tenant ID and are signing into the correct cloud. Check with your subscription administrator, this may happen if there are no active subscriptions for the tenant. Trace ID: 35c4258e-a231-46f0-b0f1-9ff71d354800 Correlation ID: 96b16d07-830b-4140-a990-2301d9ceee2a Timestamp: 2024-06-07 11:03:45Z",
* **client id wrong**
* The configured OAuth 2 client id is invalid. Please check the configuration.
* AADSTS700016: Application with identifier 'b8a5bb54-5fb2-4e0e-9427-9d24dbac32fe' was not found in the directory 'MSFT'. This can happen if the application has not been installed by the administrator of the tenant or consented to by any user in the tenant. You may have sent your authentication request to the wrong tenant. Trace ID: 2817fb27-5d4d-4c3b-8d46-ab0f14ae1a00 Correlation ID: 784c7425-b779-4587-9840-01f1f1f6d1f4 Timestamp: 2024-06-07 11:05:06Z
* **client secret wrong**
* The configured OAuth 2 client secret is invalid. Please check the configuration.
* AADSTS7000215: Invalid client secret provided. Ensure the secret being sent in the request is the client secret value, not the client secret ID, for a secret added to app 'b8a5bb54-5fb2-4e0e-9427-9d24dbac32ff'. Trace ID: d6464506-5697-4156-95ae-982351361500 Correlation ID: 809503e5-8a88-487f-85b3-6d3b074fc442 Timestamp: 2024-06-07 11:06:42Z
* **unknown error**
* The connection could not be validated. An unknown error occurred. Please check the server logs for further information.
* **Success**
* The connection works as expected.
* **Automatically managed project folder is activated and drive as content**
* Unexpected content found in the drive.
**Figma Design**
https://www.figma.com/design/gtLQfPe09X7XugAH8L7dTy/File-Storages-Integration?node-id=8620-3874&t=LshLduIvL8FiDSUy-0
**I want to** trigger a test of the connection to an OneDrive/SharePoint
**so that** I can verify if the storages works as expected and get helpful feedback otherwise.
**Acceptance criteria**
* A button allows for a manual trigger of a connection test and validation of the settings of a OneDrive/SharePoint storage.
* If an error raises during the test, it is shown with an explanation and helpful information.
* If the test and validations are successful, it is clearly communicated to the user.
* Validations:
* The external storage server is reachable
* The oAuth2 settings are valid
* The Drive Id and tenant Id is valid
* When "automatically managed project folders" is activated in the management section, the drive needs to be empty
**Additional info**
* The "Validate/Test Connection" is quite independent from the Health status.
* Health status is only relevant for Storages with automatically managed project folders
* Test connection relates to all storages
* Validation messages
* **not configured**
* UI text: The connection could not be validated. Please finish configuration first.
* **drive id wrong**
* UI text: The configured drive id could not be found. Please check the configuration.
* Internal error: `code=>"itemNotFound", :message=>"Item not found"`
* **tenant id wrong**
* UI text: The configured directory (tenant) id is invalid. Please check the configuration.
* Payload: "AADSTS90002: Tenant 'e36f1dbc-fdae-427e-b61b-0d96ddfb81a5' not found. Check to make sure you have the correct tenant ID and are signing into the correct cloud. Check with your subscription administrator, this may happen if there are no active subscriptions for the tenant. Trace ID: 35c4258e-a231-46f0-b0f1-9ff71d354800 Correlation ID: 96b16d07-830b-4140-a990-2301d9ceee2a Timestamp: 2024-06-07 11:03:45Z",
* **client id wrong**
* The configured OAuth 2 client id is invalid. Please check the configuration.
* AADSTS700016: Application with identifier 'b8a5bb54-5fb2-4e0e-9427-9d24dbac32fe' was not found in the directory 'MSFT'. This can happen if the application has not been installed by the administrator of the tenant or consented to by any user in the tenant. You may have sent your authentication request to the wrong tenant. Trace ID: 2817fb27-5d4d-4c3b-8d46-ab0f14ae1a00 Correlation ID: 784c7425-b779-4587-9840-01f1f1f6d1f4 Timestamp: 2024-06-07 11:05:06Z
* **client secret wrong**
* The configured OAuth 2 client secret is invalid. Please check the configuration.
* AADSTS7000215: Invalid client secret provided. Ensure the secret being sent in the request is the client secret value, not the client secret ID, for a secret added to app 'b8a5bb54-5fb2-4e0e-9427-9d24dbac32ff'. Trace ID: d6464506-5697-4156-95ae-982351361500 Correlation ID: 809503e5-8a88-487f-85b3-6d3b074fc442 Timestamp: 2024-06-07 11:06:42Z
* **unknown error**
* The connection could not be validated. An unknown error occurred. Please check the server logs for further information.
* **Success**
* The connection works as expected.
* **Automatically managed project folder is activated and drive as content**
* Unexpected content found in the drive.
https://www.figma.com/design/gtLQfPe09X7XugAH8L7dTy/File-Storages-Integration?node-id=8620-3874&t=LshLduIvL8FiDSUy-0