Linkshare read object metadata and content-type

Zetanova · July 17, 2024, 10:35am

I can’t find much documentation about the supported features of the linkshare feature.

I implemented a simple screenshot upload endpoint and using currently the hidden wrap query param like “https://mydomain.test/thefile.png?wrap”

The missing support of the link-preview for fb & skype and co. requires me also to implement my own preview page.

For this it would be nice to be able to query the object metadata over the shared link to be able to access them inside the preview page and not on the server over regular S3 request.

The content type of the http-response of the object seams to be generated over the filename.

Are there hidden metadata fields that sharelink can use like:
“filename” to set the download filename
“content-type” to set the content type
“redirect” for an http redirect
… and others?

Best would be in general to let linkshare read a single wellknow metadata property and at it to the http-response headers like:
object meta: {‘http’: { ‘status’: ‘302 Found’, ‘headers’: { ‘location’: ‘https://www.example.org/index.php’, ‘x-myheader’: ‘ok’ } }
would hive a http response:
HTTP/1.1 302 Found
Location: https://www.example.org/index.php
x-myheader: ok
… others

or for filename:
object url: “https://mydomain.test/2024/radhwe”
object meta: {‘http’: { ‘headers’: { ‘Content-Disposition’: ‘attachment; filename=“origname.png”’ } }

HTTP/1.1 200 OK
Content-Disposition: attachment; filename=“origname.png”
…others

Alexey · July 18, 2024, 4:26am

We have a usage documentation:

We have a technical documentation as well:

github.com

storj/edge/blob/82d843c4a692e511ef10611042743aed5c205447/docs/linksharing.md

# Link Sharing Service

## Building

```
$ go install storj.io/gateway-mt
```

## Configuring

### Development

Default development configuration has the link sharing service hosted on
`localhost:20020` serving plain HTTP.

```
$ linksharing setup --defaults dev
```

### Production

This file has been truncated. show original

And regarding the metadata too: edge/docs/linksharing.md at 82d843c4a692e511ef10611042743aed5c205447 · storj/edge · GitHub

So, actually the content metadata is provided/detected on upload of the object and then used by the Linksharing service to allow/disallow a preview.

You may also see most of the flags (similar to ?wrap) here:

github.com

storj/edge/blob/82d843c4a692e511ef10611042743aed5c205447/pkg/linksharing/sharing/present.go#L188


      
          		if !strings.HasSuffix(r.URL.Path, "/") {
          			http.Redirect(w, r, r.URL.Path+"/", http.StatusSeeOther)
          			return nil
          		}
          		return handler.servePrefix(ctx, w, project, pr, "", cursor)
          	default:
          		return errdata.WithAction(err, "unexpected case")
          	}
          }
          
          func (handler *Handler) showObject(ctx context.Context, w http.ResponseWriter, r *http.Request, pr *parsedRequest, project *uplink.Project, o *uplink.Object, d *uplink.Download, httpRange httpranger.HTTPRange) (err error) {
          	defer mon.Task()(&ctx)(&err)
          
          	q := r.URL.Query()
          
          	mapOnly := queryFlagLookup(q, "map", false)
          
          	// if someone provides the 'download' flag on or off, we do that, otherwise
          	// we do what the downloadDefault was (based on the URL scope).
          	download := queryFlagLookup(q, "download", pr.downloadDefault)
          	// if we're not downloading, and someone provides the 'wrap' flag on or off,

However, they likely wouldn’t work on custom domains out of the box, or you would show the Storj branded page. In other words, you usually need to implement a preview yourself.
Usually the custom domains are used for Hosting a Static Website - Storj Docs and when you open it without an object name, it would try to search for index.html or similar page. So, perhaps you may implement there a preview which can be rendered on a static website.

Zetanova · July 18, 2024, 8:52am

Thx, i only looked on google and storj.com doc.
Most of the features are already there/implemented.

Link Preview does not work somehow.
I think it’s because the link is shared with ?wrap, need to test it out.

A metadata option for location+status header for to create a redirect would be nice to have.
With it a link shortened could be implemented.

HEAD request is handled currently and could be used to retrieve some metadata

The custom headers combined with the HEAD request could be used inside the preview page itself to load some required information like the optimized preview-image url’s or something exetic like an SSL or OTS signatures https://opentimestamps.org/

Zetanova · July 18, 2024, 9:25am

@Alexey The link-preview url of the generated html-meta are buggy.
If a custom domain is used then they still generate link.storjshare.io url’s to a 404 request.

Example:
https://mydomain.test/2024-29/T11187a.png?wrap

will include for the og:image and twitter:image html meta tags the url:
https://link.storjshare.io/raw/my-bucket/2024-29/T11187a.png?v=ab52919
and it returns 404

Reported this issue here too

github.com/storj/edge

Linksharing: Open Graph meta tags

opened 08:06PM - 23 Apr 24 UTC

mobyvb

Needs Estimation console team

Currently, when a linksharing link is shared on social media, there is no previe…w image, or other information that would make the shared link more eye-catching. This should be easy to solve by adding [Open Graph meta tags](https://ahrefs.com/blog/open-graph-meta-tags/). ### AC: * Add `og:title` meta tag to file share `<head>` code with `content` set to the filename * If an image preview is possible, add `og:image` meta tag to file share `<head>` code with `content` set to the path of the preview. For an image, this would be the same page, but with the query param `?download=1` set

Alexey · July 19, 2024, 7:08am

Oh, I now get it. You mean the preview on the social media, not our preview service on linksharing.

Zetanova · July 21, 2024, 1:12pm

Yes, preview for the chat app whatsapp, skype and so on