41 add auth to harvest api

[sekmiller]

What this PR does / why we need it: The Delete Harvesting set api did not require any credentials. To mimic the ui super user permissions have been added. Also the modify harvesting set api end point had not been implemented so that was completed. And finally all of the Manage Harvesting sets apis were documented as they had not been previously.

Which issue(s) this PR closes:

Closes # https://github.com/IQSS/dataverse-security/issues/41
and closes #4514 Document Harvesting set endpoints

Special notes for your reviewer: There was also and endpoint for "/datasets" which returns an empty string. It's not clear what the intended response is, possibly a count of datasets that would be harvested given the definition. Without a clear intent I left it as I found it.

Suggestions on how to test this: verify that the endpoints work as documented and that a non-super user may not create, modify or delete a harvesting set.

Does this PR introduce a user interface change? If mockups are available, please link/include them here: no

Is there a release notes update needed for this change?:

Additional documentation:

[github-actions]

[reviewdog] _{reported by reviewdog 🐶}
'{' at column 2 should be on the previous line.

[sekmiller]

OK bot, point to you.

[coveralls]

Coverage decreased (-0.009%) to 19.017% when pulling dbd68e0 on 41-add-auth-to-harvest-api into 97b7c88 on develop.

[djbrooke]

@sekmiller I'm going to rerun the tests on this issue, just seeing if it was an intermittent failure

[djbrooke]

(updating from develop to rerun the tests)

[djbrooke]

OK! Tests pass. I'll unassign myself so that someone can review this.

[pdurbin]

One quick thing is that the docs don't built, even though it says "all checks have passed" above.

[djbrooke]

I wrote these guides, so I broke them. I will fix.

[kcondon]

having trouble with create set

curl -H X-Dataverse-key:xxxx-yyyy-zzzz-aaaa -X POST "http://localhost:8080/api/harvest/server/oaisets/" --upload-file harvestset1.json
{"status":"ERROR","code":405,"message":"API endpoint does not support this method. Consult our API guide at http://guides.dataverse.org.","requestUrl":"http://localhost:8080/api/v1/harvest/server/oaisets/harvestset1.json","requestMethod":"POST"}[root@dataverse-internal tmp]# cat harvestset1.json
{
"name":"ffAuthor",
"definition":"authorName:Finch, Fiona",
"description":"Fiona Finch’s Datasets"
}

[kcondon]

tested endpoints, work as expected, slight doc issue with curved " chars in examples not working when cut and paste.

[djbrooke]

My bad on the docs @kcondon @sekmiller - should be OK now.