Upload files
You can give the agent a file from your computer. Attach the file to a message in a session. The agent reads the file with that message.
Attach a file to a message
-
Click the plus icon in the bottom left corner of the message box. A menu opens.
-
Click Attach file.
-
Select one or more files in the file chooser.
-
Optional: type your message in the message box. You can send files without text.
-
Press Enter.
Hyground uploads each file when you send the message.
Two other ways lead to the same result:
- Drag a file from your computer onto the message box. The border of the box changes color while you hold the file over it.
- Copy a file and paste it into the message box. Hyground gives a pasted image a new file name.
Which files can you attach?
- Each file can be at most 2 MiB. Your administrator can change this limit. The warning for a larger file names the limit that applies.
- The file chooser offers text, code, configuration, and log files.
- It also offers CSV, JSON, XML, YAML, PDF, ZIP, image, Word, Excel, and PowerPoint files.
- One message cannot hold two files with the same name.
- Hyground replaces spaces and the characters
: * ? " < > | # % ,in a file name with_. It also writes the extension in lowercase. The file shows the new name after the upload.
Hyground shows a warning when it refuses a file. Each warning names the reason. See Troubleshooting.
How does the agent see an image?
- The agent gets a compressed copy of a PNG, JPEG, or WebP image. Hyground uses the copy only when it is smaller than the image. The copy is at most 2000 pixels wide and 2000 pixels high.
- An image above 20 megapixels and a GIF image reach the agent unchanged.
- The file in the session keeps its original size.
- The agent sees at most the 50 newest images of a session at the same time. It can open an older PNG, JPEG, or WebP image again, up to 20 megapixels.
What happens to an attached file?
The card shows a spinning circle while the upload runs. You cannot remove a file or send the message while it uploads.
Remove a file
- Point to the card of the file.
- Click the cross on the card.
The file leaves your message. Attach it again if you removed it by mistake.
Retry a failed upload
Hyground does not send the message when an upload fails. The card of the file turns red and shows a circular arrow. A red notice above the cards names each failed file and the reason. Your text stays in the message box.
- Find the red card of the file.
- Press Enter.
Hyground uploads each failed file once more. It sends the message when every upload succeeds. If an upload fails again, Hyground does not send the message.
To upload one file again without sending, click the circular arrow on its card. To send the message without a failed file, remove the file first. See Remove a file.
In a new session, Hyground opens the session before it uploads the files. If an upload fails, Hyground does not send the message. Your text and the red card are in the message box of that session.
Open a file you attached
Before you send, an image gets a card with a small preview. Click that preview to open the image in a window.
After you send the message, each file sits above your message text. Click the name of a file to open its preview. The preview holds a download icon.
Markdown (.md) files show a short, formatted preview. Click the preview to
read the full file beside the session. Copy, download, and close controls sit
above the file. You can quote selected text from this view.
Can you give the agent scanner findings?
Yes. Each line of the file is one JSON object: a finding, or an image that the scanner found clean. See Check for vulnerabilities and security events.
Who can open your files?
A file you attach belongs to the session. It follows the rules of that session. See Who can read your data? and Who can see a session?.
The agent keeps the findings from a scanner file that it rates against the Security Feed. Every user of your installation can read them, even when the session is private. Attach no scanner file whose findings others must not read.